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

Artigo
02/06/2025

A função DxgkDdiRecommendFunctionalVidPn cria um VidPN funcional que pode ser implementado em um adaptador de exibição especificado.

Sintaxe

DXGKDDI_RECOMMENDFUNCTIONALVIDPN DxgkddiRecommendfunctionalvidpn;

NTSTATUS DxgkddiRecommendfunctionalvidpn(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_RECOMMENDFUNCTIONALVIDPN_CONST pRecommendFunctionalVidPn
)
{...}

Parâmetros

[in] hAdapter

Um identificador para um bloco de contexto associado a um adaptador de exibição. O driver de miniporto de exibição forneceu anteriormente esse identificador para o subsistema de kernel de elementos gráficos DirectX na função MiniportDeviceContext da função DxgkDdiAddDevice.

[in] pRecommendFunctionalVidPn

Um ponteiro para uma estrutura DXGKARG_RECOMMENDFUNCTIONALVIDPN que contém argumentos de função. O chamador fornece o membro hRecommendedFunctionalVidPn, que é um identificador para um objeto VidPN vazio. DxgkDdiRecommendFunctionalVidPn popula o objeto VidPN com os elementos de um VidPN funcional: topologia, conjuntos de modos, modos fixados.

Valor de retorno

DxgkDdiRecommendFunctionalVidPn retorna um dos seguintes valores:

Código de retorno	Descrição
STATUS_SUCCESS	A função conseguiu criar um VidPN funcional.
STATUS_GRAPHICS_NO_RECOMMENDED_FUNCTIONAL_VIDPN	A função não foi capaz de criar um VidPN funcional.
STATUS_NO_MEMORY	A função falhou porque não foi possível alocar memória.

Observações

Um VidPN estará funcional se atender às seguintes condições:

Ele tem uma topologia que tem pelo menos um caminho. (Um caminho é uma associação entre uma origem e um destino.)
Cada origem e destino na topologia tem um modo fixado.

O trabalho de DxgkDdiRecommendFunctionalVidPn é criar um VidPN funcional que possa ser implementado no adaptador de exibição. A lista a seguir fornece as etapas usadas para criar um VidPN funcional.

Comece com um identificador para um objeto VidPN vazio. Esse identificador foi fornecido no hDesiredVidPn membro do pRecommendFunctionalVidPnArg.
Adicione um caminho (par de destino de origem) à topologia do VidPN.
Crie um novo conjunto de modo de origem e adicione um modo de origem ao conjunto. Atribua o modo de origem definido à origem em seu caminho. Fixe o modo de origem.
Crie um novo conjunto de modo de destino e adicione um modo de destino ao conjunto. Atribua o modo de destino definido ao destino em seu caminho. Fixe o modo de destino.

Para obter informações sobre como adicionar caminhos, adicionar conjuntos de modos, atribuir modos e modos de fixação, consulte VidPN Objects and Interfaces.

DxgkDdiRecommendFunctionalVidPn deve ser tornada paginável.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista
da Plataforma de Destino	Área de trabalho
cabeçalho	d3dkmddi.h
IRQL	PASSIVE_LEVEL

Partilhar via