次の方法で共有

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 つを返します。

備考

ディスプレイ アダプターのすべての子デバイスがオンボードされます。ディスプレイ アダプターに接続するモニターやその他の外部デバイスは、子デバイスとは見なされません。

ディスプレイ ミニポート ドライバーは、ディスプレイ アダプターの子ごとに 1 つずつ、DXGK_CHILD_DESCRIPTOR構造体の配列を入力する必要があります。 配列には、現在のすべての子デバイスと潜在的なすべての子デバイスのDXGK_CHILD_DESCRIPTOR構造体が含まれている必要があります。 たとえば、ポータブル コンピューターをドッキングすると、新しいビデオ出力が使用可能になる場合、それらのビデオ出力は、現在使用できない場合でも、配列内の記述子を持っている必要があります。

DxgkDdiQueryChildRelations 関数をページング可能にする必要があります。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista
ターゲット プラットフォーム の デスクトップ
ヘッダー dispmprt.h
IRQL PASSIVE_LEVEL

関連項目

DXGK_CHILD_DESCRIPTOR

DXGK_CHILD_STATUS

DxgkDdiQueryChildStatus を する

DxgkDdiQueryDeviceDescriptor を する