次の方法で共有


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 関数の呼び出しが開始されます。

  • DxgkrnlDXGKARG_QUERYADAPTERINFO::TypeでDXGKQAITYPE_UMDRIVERPRIVATEを指定する場合、pOutputData は、UMD がアダプターを識別するために必要な構成情報を KMD が入力する独自の構造を指します。

  • Dxgkrnl DXGKARG_QUERYADAPTERINFO::TypeでDXGKQAITYPE_DRIVERCAPSを指定する場合、KMD は指定された DXGK_DRIVERCAPS 構造体にサブシステムが使用できる情報を設定する必要があります。

  • DxgkrnlDXGKARG_QUERYADAPTERINFO::TypeでDXGKQAITYPE_QUERYSEGMENTを指定する場合、KMD はサポートするメモリ セグメントに関する情報を提供する必要があります。 メモリ セグメントの詳細については、「メモリ セグメントの使用の初期化」を参照してください。

DxgkDdiQueryAdapterInfo ページング可能にする必要があります。

WDDM 2.6 以降をサポートするすべてのドライバーは、DxgkDdiQueryAdapterInfo コールバックを実装する必要があります。

必要条件

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

関連項目

DXGKARG_QUERYADAPTERINFO

DxgkDdiAddDevice

pfnQueryAdapterInfoCb