DXGKDDI_QUERY_CHILD_STATUS コールバック関数 (dispmprt.h)
DxgkDdiQueryChildStatus 関数は、ディスプレイ アダプターの個々の子デバイスの状態を返します。
構文
DXGKDDI_QUERY_CHILD_STATUS DxgkddiQueryChildStatus;
NTSTATUS DxgkddiQueryChildStatus(
[in] IN_CONST_PVOID MiniportDeviceContext,
[in, out] INOUT_PDXGK_CHILD_STATUS ChildStatus,
[in] IN_BOOLEAN NonDestructiveOnly
)
{...}
パラメーター
[in] MiniportDeviceContext
ディスプレイ アダプターに関連付けられているコンテキスト ブロックへのハンドル。 ディスプレイ ミニポート ドライバーの DxgkDdiAddDevice 関数は、以前に DirectX グラフィックス カーネル サブシステムにこのハンドルを提供しました。
[in, out] ChildStatus
DXGK_CHILD_STATUS 構造体へのポインター。 呼び出し元は、ChildStatus->Type と ChildStatus->ChildUid を提供します。 返されると、残りの構造体メンバー (共用体) は要求された状態を受け取ります。
[in] NonDestructiveOnly
表示ミニポート ドライバーが、視覚的な成果物を引き起こす方法で要求された状態を判断できるかどうかを指定するブール値。 呼び出し元が TRUE このパラメーターを設定する場合、ディスプレイ ミニポート ドライバーは、成果物を引き起こすことが許可されていません。 呼び出し元が FALSE このパラメーターを設定する場合、ディスプレイ ミニポート ドライバーは、成果物を引き起こすことが許可されます。
戻り値
DxgkDdiQueryChildStatus 成功した場合、STATUS_SUCCESSが返されます。それ以外の場合は、Ntstatus.hで定義されているエラー コードの 1 つを返します。
備考
初期化中、ディスプレイ ポート ドライバーは DxgkDdiQueryChildRelations を呼び出して、ミニポートDeviceContextによって表されるディスプレイ アダプターの子であるデバイスの一覧を取得します。 次に、hpdAwarenessPolled または HpdAwarenessInterruptibleの HPD 認識値を持つ各子について、ディスプレイ ポート ドライバーは DxgkDdiQueryChildStatus 呼び出して、子が現在ハードウェア (モニターなど) に接続されているかどうかを判断します。
DxgkDdiQueryChildStatus 、次のアクションを実行する必要があります。
- ChildStatus->Type が StatusConnection 等しい場合は、ChildStatus->HotPlug.Connected でブール値を返します。 ChildStatus->ChildUid によって識別される子デバイスに外部ハードウェアが接続されている場合は、TRUE 返します。それ以外 FALSEを返します。
- ChildStatus->Type が StatusRotationと等しい場合は、ChildStatus->Rotation.Angle で識別される子デバイスに接続されているディスプレイの回転角度を返>ChildUid。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista |
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | dispmprt.h |
| IRQL | PASSIVE_LEVEL |
関連項目
DxgkDdiQueryChildRelations の