DXGKCB_QUERYVIDPNINTERFACE funzione di callback (d3dkmddi.h)

Articolo
02/25/2024

DXGKCB_QUERYVIDPNINTERFACE ottiene un puntatore a una struttura DXGK_VIDPN_INTERFACE , che contiene puntatori alle funzioni che il driver miniport visualizzato può chiamare per controllare e modificare un oggetto VidPN.

Sintassi

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
)
{...}

Parametri

[in] hVidPn

Handle per un oggetto VidPN. In precedenza il gestore VidPN ha fornito il driver miniport visualizzato con questo handle chiamando DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn o DxgkDdiRecommendFunctionalVidPn.

[in] VidPnInterfaceVersion

Enumeratore DXGK_VIDPN_INTERFACE_VERSION che specifica la versione dell'interfaccia VidPN richiesta. I chiamanti devono impostare questo parametro su DXGK_VIDPN_INTERFACE_VERSION_V1.

[out] ppVidPnInterface

Puntatore a una variabile che riceve un puntatore alla struttura DXGK_VIDPN_INTERFACE .

Valore restituito

DxgkCbQueryVidPnInterface restituisce uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	Funzione completata.
STATUS_INVALID_PARAMETER	Il valore passato a ppVidPnInterface non è valido.
STATUS_GRAPHICS_INVALID_VIDPN	L'handle passato a hVidPn non è valido.
STATUS_NOT_SUPPORTED	La versione dell'interfaccia specificata da VidPnInterfaceVersion non è supportata.

Commenti

DXGKCB_XXX funzioni vengono implementate da Dxgkrnl. Per usare questa funzione di callback, il driver in modalità kernel chiama DxgkCbQueryVidInterface tramite il DXGKRNL_INTERFACE.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista (WDDM 1.0)
Piattaforma di destinazione	Desktop
Intestazione	d3dkmddi.h (include D3dkmddi.h)
IRQL	<= APC_LEVEL