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

Artículo
02/23/2024

DXGKCB_QUERYVIDPNINTERFACE obtiene un puntero a una estructura 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 de VidPN proporcionó anteriormente el controlador de miniporte para mostrar con este identificador llamando a DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn o DxgkDdiRecommendFunctionalVidPn.

[in] VidPnInterfaceVersion

Enumerador de DXGK_VIDPN_INTERFACE_VERSION que especifica la versión de la interfaz VidPN solicitada. 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 ha realizado 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.

Comentarios

Dxgkrnl implementa DXGKCB_XXX funciones. Para usar esta función de devolución de llamada, el controlador en modo kernel llama a DxgkCbQueryVidPnInterface a través del DXGKRNL_INTERFACE.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista (WDDM 1.0)
Plataforma de destino	Escritorio
Encabezado	d3dkmddi.h (incluye D3dkmddi.h)
IRQL	<= APC_LEVEL