コールバック関数DXGKDDI_GET_CHILD_CONTAINER_ID (dispmprt.h)
指定したターゲットのコンテナー ID を照会します。 Windows ディスプレイ ドライバー モデル (WDDM) 1.2 以降のディスプレイ ミニポート ドライバーによって実装されます。
構文
DXGKDDI_GET_CHILD_CONTAINER_ID DxgkddiGetChildContainerId;
NTSTATUS DxgkddiGetChildContainerId(
[in] PVOID MiniportDeviceContext,
[in] ULONG ChildUid,
[in, out] PDXGK_CHILD_CONTAINER_ID ContainerId
)
{...}
パラメーター
[in] MiniportDeviceContext
ディスプレイ アダプターに関連付けられているコンテキスト ブロックへのハンドル。 ディスプレイ ミニポート ドライバーの DxgkDdiAddDevice 関数は、以前は Microsoft DirectX グラフィックス カーネル サブシステムにこのハンドルを提供しました。
[in] ChildUid
子デバイスを一意に識別する ULONG 値。 ディスプレイ ミニポート ドライバーは、 DxgkDdiQueryChildRelations 関数が呼び出されたときに、この識別子を以前に指定しました。
[in, out] ContainerId
DXGK_CHILD_CONTAINER_ID構造体へのポインター。 詳細については、「解説」を参照してください。
戻り値
次のいずれかのエラー コードを返します。
| リターン コード | 説明 |
|---|---|
| STATUS_SUCCESS | ドライバーは、表示ハードウェアから取得したコンテナー ID 情報を使用して、ContainerId パラメーターによって指される構造体を更新しました。 |
| STATUS_MONITOR_NODESCRIPTOR | ドライバーは、ContainerId によって指される構造体で提供される既定のコンテナー ID 情報を受け入れます。 メモ： ドライバーがこの状態コードを返す場合は、構造体を変更しないでください。 |
それ以外の場合、関数は Ntstatus.h で定義されている状態コードのいずれかを返します。
注釈
オペレーティング システムは、ディスプレイ ミニポート ドライバーの DxgkDdiQueryChildRelations 関数を呼び出して、ディスプレイ アダプターの子デバイスを列挙します。 次に、オペレーティング システムは、各子デバイスのディスプレイ ミニポート ドライバーの DxgkDdiQueryDeviceDescriptor 関数を呼び出して、デバイスの拡張表示情報データ (EDID) を取得します。 この手順の詳細については、「 ディスプレイ アダプターの子デバイスの列挙」を参照してください。
オペレーティング システムは、デバイスの EDID データに基づいて、子デバイスの既定のコンテナー ID を生成します。 次に、オペレーティング システムはディスプレイ ミニポート ドライバーの DxgkDdiGetChildContainerId 関数を呼び出し、ContainerId パラメーターを使用してDXGK_CHILD_CONTAINER_ID構造体へのポインターを渡します。 この構造体の ContainerId メンバーには、子ディスプレイ デバイスの既定のコンテナー ID が含まれています。
ディスプレイ ミニポート ドライバーは、既定のコンテナー ID を受け入れるか、DxgkDdiGetChildContainerId の呼び出しから返される前に、デバイスの一意の識別子に ContainerId メンバーを設定できます。
コンテナー ID の詳細については、「 コンテナー ID」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 |
| サポートされている最小のサーバー | Windows Server 2012 |
| 対象プラットフォーム | デスクトップ |
| Header | dispmprt.h |
| IRQL | PASSIVE_LEVEL |