コールバック関数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 以降のバージョンの Windows オペレーティング システムで使用できます。
対象プラットフォーム デスクトップ
Header dispmprt.h
IRQL PASSIVE_LEVEL

こちらもご覧ください

DXGK_CHILD_DESCRIPTOR

DXGK_CHILD_STATUS

DxgkDdiQueryChildStatus

DxgkDdiQueryDeviceDescriptor