DXGKCB_QUERYVIDPNINTERFACE função de retorno de chamada (d3dkmddi.h)

Artigo
02/23/2024

DXGKCB_QUERYVIDPNINTERFACE obtém um ponteiro para uma estrutura DXGK_VIDPN_INTERFACE , que contém ponteiros para funções que o driver de miniporto de exibição pode chamar para inspecionar e alterar um objeto VidPN.

Sintaxe

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

Um identificador para um objeto VidPN. O gerenciador do VidPN forneceu anteriormente o driver de miniporto de exibição com esse identificador chamando DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn ou DxgkDdiRecommendFunctionalVidPn.

[in] VidPnInterfaceVersion

Um enumerador DXGK_VIDPN_INTERFACE_VERSION que especifica a versão da interface VidPN que está sendo solicitada. Os chamadores devem definir esse parâmetro como DXGK_VIDPN_INTERFACE_VERSION_V1.

[out] ppVidPnInterface

Um ponteiro para uma variável que recebe um ponteiro para a estrutura DXGK_VIDPN_INTERFACE .

Retornar valor

DxgkCbQueryVidPnInterface retorna um dos seguintes valores:

Código de retorno	Descrição
STATUS_SUCCESS	A função foi bem-sucedida.
STATUS_INVALID_PARAMETER	O valor passado para ppVidPnInterface não é válido.
STATUS_GRAPHICS_INVALID_VIDPN	O identificador passado para hVidPn não é válido.
STATUS_NOT_SUPPORTED	Não há suporte para a versão da interface especificada por VidPnInterfaceVersion.

Comentários

DXGKCB_XXX funções são implementadas por Dxgkrnl. Para usar essa função de retorno de chamada, o driver do modo kernel chama DxgkCbQueryVidPnInterface por meio do DXGKRNL_INTERFACE.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista (WDDM 1.0)
Plataforma de Destino	Área de Trabalho
Cabeçalho	d3dkmddi.h (inclua D3dkmddi.h)
IRQL	<= APC_LEVEL