DXGKDDI_QUERYADAPTERINFO コールバック関数 (d3dkmddi.h)

  • [アーティクル]

DxgkDdiQueryAdapterInfo 関数は、グラフィックス アダプターから構成情報を取得します。

構文

DXGKDDI_QUERYADAPTERINFO DxgkddiQueryadapterinfo;

NTSTATUS DxgkddiQueryadapterinfo(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_QUERYADAPTERINFO pQueryAdapterInfo
)
{...}

パラメーター

[in] hAdapter

ディスプレイ アダプターに関連付けられているコンテキスト ブロックへのハンドル。 ディスプレイ ミニポート ドライバーは、以前、DxgkDdiAddDevice 関数の MiniportDeviceContext 出力パラメーターで Microsoft DirectX グラフィックス カーネル サブシステムにこのハンドルを提供しました。

[in] pQueryAdapterInfo

ディスプレイ ミニポート ドライバーがグラフィックス アダプターの構成情報を入力する 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 メンバー内の独自のバッファーを受け取り、ユーザー モード ディスプレイ ドライバーがアダプターを識別するために必要な構成情報を入力します。

DirectX グラフィックス カーネル サブシステム (Dxgkrnl.sysの一部) で、サブシステムが 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

こちらもご覧ください

DXGKARG_QUERYADAPTERINFO

DxgkDdiAddDevice

pfnQueryAdapterInfoCb