Partilhar via

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

  • Artigo

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 kernel de elementos gráficos DirectX no parâmetro de saída 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 preenche o objeto VidPN com os elementos de um VidPN funcional: topologia, conjuntos de modos, modos fixados.

Retornar valor

DxgkDdiRecommendFunctionalVidPn retorna um dos seguintes valores:

Código de retorno Descrição
STATUS_SUCCESS A função foi bem-sucedida na criação de 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.

Comentários

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.
  1. Comece com um identificador para um objeto VidPN vazio. Esse identificador foi fornecido no membro hDesiredVidPn de pRecommendFunctionalVidPnArg.
  2. Adicione um caminho (par de destino de origem) à topologia do VidPN.
  3. 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.
  4. 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 Objetos e Interfaces VidPN.

DxgkDdiRecommendFunctionalVidPn deve ser tornado paginável.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Plataforma de Destino Área de Trabalho
Cabeçalho d3dkmddi.h
IRQL PASSIVE_LEVEL