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