DXGKDDI_QUERY_CHILD_RELATIONS コールバック関数 (dispmprt.h)
DxgkDdiQueryChildRelations 関数は、ディスプレイ アダプターの子デバイスを列挙します。
構文
DXGKDDI_QUERY_CHILD_RELATIONS DxgkddiQueryChildRelations;
NTSTATUS DxgkddiQueryChildRelations(
[in] IN_CONST_PVOID MiniportDeviceContext,
[in, out] PDXGK_CHILD_DESCRIPTOR ChildRelations,
[in] ULONG ChildRelationsSize
)
{...}
パラメーター
[in] MiniportDeviceContext
ディスプレイ アダプターに関連付けられているコンテキスト ブロックへのハンドル。 ディスプレイ ミニポート ドライバーの DxgkDdiAddDevice 関数は、以前は DirectX グラフィックス カーネル サブシステムにこのハンドルを提供しました。
[in, out] ChildRelations
呼び出し元によって割り当てられ、ゼロにされた DXGK_CHILD_DESCRIPTOR 構造体の配列へのポインター。 配列内の要素の数は、NumberOfChildren パラメーターで DxgkDdiStartDevice によって返される値より 1 大きいです。 DxgkDdiQueryChildRelations は、配列内の最後の構造体以外のすべての構造体に、ディスプレイ アダプターの子デバイスを記述する情報を入力する必要があります。 配列内の最後の構造体はゼロのままである必要があります。
[in] ChildRelationsSize
末尾にゼロが付いた構造体を含む ChildRelations 配列の合計サイズ (バイト単位)。
戻り値
DxgkDdiQueryChildRelations は 、成功した場合STATUS_SUCCESSを返します。それ以外の場合は、 Ntstatus.h で定義されているエラー コードのいずれかを返します。
注釈
ディスプレイ アダプターのすべての子デバイスがオンボードされます。ディスプレイ アダプターに接続するモニターやその他の外部デバイスは、子デバイスとは見なされません。
ディスプレイ ミニポート ドライバーは、ディスプレイ アダプターの子ごとに 1 つずつ、DXGK_CHILD_DESCRIPTOR構造体の配列を入力する必要があります。 配列には、現在のすべての子デバイスとすべての潜在的な子デバイスのDXGK_CHILD_DESCRIPTOR構造が含まれている必要があります。 たとえば、ポータブル コンピューターをドッキングすると、新しいビデオ出力が使用可能になる場合、それらのビデオ出力には、現在使用できない場合でも、配列に記述子が必要です。
DxgkDdiQueryChildRelations 関数をページング可能にする必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| 対象プラットフォーム | デスクトップ |
| Header | dispmprt.h |
| IRQL | PASSIVE_LEVEL |