DXGKCB_QUERYVIDPNINTERFACE función de devolución de llamada (d3dkmddi.h)

Artículo
02/06/2025

DXGKCB_QUERYVIDPNINTERFACE obtiene un puntero a una estructura de DXGK_VIDPN_INTERFACE, que contiene punteros a funciones a las que el controlador de miniporte de pantalla puede llamar para inspeccionar y modificar un objeto VidPN.

Sintaxis

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

Parámetros

[in] hVidPn

Identificador de un objeto VidPN. El administrador vidPN proporcionó previamente el controlador de miniport para mostrar con este identificador llamando a DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn, o DxgkDdiRecommendFunctionalVidPn.

[in] VidPnInterfaceVersion

Enumerador DXGK_VIDPN_INTERFACE_VERSION que especifica la versión de la interfaz VidPN que se solicita. Los autores de llamadas deben establecer este parámetro en DXGK_VIDPN_INTERFACE_VERSION_V1.

[out] ppVidPnInterface

Puntero a una variable que recibe un puntero a la estructura DXGK_VIDPN_INTERFACE.

Valor devuelto

dxgkCbQueryVidPnInterface devuelve uno de los siguientes valores:

Código devuelto	Descripción
STATUS_SUCCESS	La función se realizó correctamente.
STATUS_INVALID_PARAMETER	El valor pasado a ppVidPnInterface no es válido.
STATUS_GRAPHICS_INVALID_VIDPN	El identificador pasado a hVidPn no es válido.
STATUS_NOT_SUPPORTED	No se admite la versión de interfaz especificada por VidPnInterfaceVersion.

Observaciones

DXGKCB_XXX funciones se implementan mediante Dxgkrnl. Para usar esta función de devolución de llamada, el controlador en modo kernel llama a dxgkCbQueryVidPnInterface a través de la DXGKRNL_INTERFACE.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista (WDDM 1.0)
de la plataforma de destino de	Escritorio
encabezado de	d3dkmddi.h (incluya D3dkmddi.h)
irQL	<= APC_LEVEL