DXGKDDI_QUERYADAPTERINFO コールバック関数 (d3dkmddi.h)
ディスプレイ ミニポートの (KMD) DxgkDdiQueryAdapterInfo 関数は、グラフィックス アダプターから構成情報を取得します。
構文
DXGKDDI_QUERYADAPTERINFO DxgkddiQueryadapterinfo;
NTSTATUS DxgkddiQueryadapterinfo(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_QUERYADAPTERINFO pQueryAdapterInfo
)
{...}
パラメーター
[in] hAdapter
ディスプレイ アダプターに関連付けられているコンテキスト ブロックへのハンドル。 KMD は以前、DxgkDdiAddDevice 関数の MiniportDeviceContext 出力パラメーターで Dxgkrnl にこのハンドルを提供しました。
[in] pQueryAdapterInfo
KMD がグラフィックス アダプターの構成情報を入力する DXGKARG_QUERYADAPTERINFO 構造体へのポインター。
戻り値
DxgkDdiQueryAdapterInfo は、次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
| STATUS_SUCCESS | DxgkDdiQueryAdapterInfo が構成情報を正常に取得しました。 |
| STATUS_INVALID_PARAMETER | DxgkDdiQueryAdapterInfo に渡されたパラメーターには、完了を妨げるエラーが含まれていました。 |
| STATUS_NO_MEMORY | DxgkDdiQueryAdapterInfo では、完了するために必要なメモリを割り当てませんでした。 |
| STATUS_GRAPHICS_DRIVER_MISMATCH | ディスプレイ ミニポート ドライバーは、DxgkDdiQueryAdapterInfo の呼び出しを開始したユーザー モードのディスプレイ ドライバーと互換性がありません (つまり、ディスプレイ ミニポート ドライバーへのクエリのプライベート データが提供されます)。 |
注釈
ユーザー モードのディスプレイ ドライバーが pfnQueryAdapterInfoCb 関数を呼び出すと、 DxgkDdiQueryAdapterInfo 関数の呼び出しが開始されます。
DxgkDdiQueryAdapterInfo が pQueryAdapterInfo パラメーターが指すDXGKARG_QUERYADAPTERINFO構造体の Type メンバーのDXGKQAITYPE_UMDRIVERPRIVATE値を受け取る場合、pOutputData は KMD がユーザー モードディスプレイ ドライバーがアダプターを識別するために必要な構成情報を入力する独自の構造体を指します。
Dxgkrnl が、サブシステムが DxgkDdiQueryAdapterInfo を呼び出すときに、DXGKARG_QUERYADAPTERINFOの Type メンバーにDXGKQAITYPE_DRIVERCAPS値を指定する場合、ディスプレイ ミニポート ドライバーは、提供されたDXGK_DRIVERCAPS構造体にサブシステムが使用できる情報を設定する必要があります。
DirectX グラフィックス カーネル サブシステムが DXGKARG_QUERYADAPTERINFO の Type メンバーにDXGKQAITYPE_QUERYSEGMENT値を提供する場合、ディスプレイ ミニポート ドライバーは、サポートされているメモリ セグメントに関する情報を提供する必要があります。 メモリ セグメントの詳細については、「メモリ セグメント の使用の初期化」を参照してください。
DxgkDdiQueryAdapterInfo をページング可能にする必要があります。
WDDM 2.6 以降をサポートするすべてのドライバーは、 DxgkDdiQueryAdapterInfo コールバックを実装する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| 対象プラットフォーム | デスクトップ |
| Header | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |