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

[アーティクル]
02/26/2024

DXGKCB_QUERYVIDPNINTERFACE は、表示ミニポートドライバーが VidPN オブジェクトを検査および変更するために呼び出すことができる関数へのポインターを含む、 DXGK_VIDPN_INTERFACE 構造体へのポインターを取得します。

構文

DXGKCB_QUERYVIDPNINTERFACE DxgkcbQueryvidpninterface;

NTSTATUS DxgkcbQueryvidpninterface(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in]  IN_CONST_DXGK_VIDPN_INTERFACE_VERSION VidPnInterfaceVersion,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPN_INTERFACE ppVidPnInterface
)
{...}

パラメーター

[in] hVidPn

VidPN オブジェクトへのハンドル。 VidPN マネージャーは、以前に DxgkDdiEnumVidPnCofuncModality、 DxgkDdiIsSupportedVidPn、または DxgkDdiRecommendFunctionalVidPn を呼び出すことによって、このハンドルをディスプレイミニポートドライバーに提供しました。

[in] VidPnInterfaceVersion

要求される VidPN インターフェイスのバージョンを指定する DXGK_VIDPN_INTERFACE_VERSION列挙子。呼び出し元は、このパラメーターを DXGK_VIDPN_INTERFACE_VERSION_V1 に設定する必要があります。

[out] ppVidPnInterface

DXGK_VIDPN_INTERFACE構造体へのポインターを受け取る変数へのポインター。

戻り値

DxgkCbQueryVidPnInterface は、次のいずれかの値を返します。

リターンコード	説明
STATUS_SUCCESS	関数が正常に実行されました。
STATUS_INVALID_PARAMETER	ppVidPnInterface に渡された値が無効です。
STATUS_GRAPHICS_INVALID_VIDPN	hVidPn に渡されるハンドルが無効です。
STATUS_NOT_SUPPORTED	VidPnInterfaceVersion で指定されたインターフェイスバージョンはサポートされていません。

注釈

DXGKCB_XXX 関数は Dxgkrnl によって実装されます。このコールバック関数を使用するには、カーネルモードドライバーは、DXGKRNL_INTERFACEを介して DxgkCbQueryVidPnInterface を呼び出します。

要件

要件	値
サポートされている最小のクライアント	Windows Vista (WDDM 1.0)
対象プラットフォーム	デスクトップ
Header	d3dkmddi.h (D3dkmddi.h を含む)
IRQL	<= APC_LEVEL