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

A função pfnGetTopology retorna um identificador para o objeto de topologia VidPN contido em um objeto VidPN especificado.

Sintaxe

DXGKDDI_VIDPN_GETTOPOLOGY DxgkddiVidpnGettopology;

NTSTATUS DxgkddiVidpnGettopology(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [out] OUT_PD3DKMDT_HVIDPNTOPOLOGY phVidPnTopology,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNTOPOLOGY_INTERFACE ppVidPnTopologyInterface
)
{...}

Parâmetros

[in] hVidPn

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

[out] phVidPnTopology

Um ponteiro para uma variável que recebe um identificador para o objeto de topologia VidPN.

[out] ppVidPnTopologyInterface

Um ponteiro para uma variável que recebe um ponteiro para uma estrutura DXGK_VIDPNTOPOLOGY_INTERFACE . A estrutura contém ponteiros para funções que o driver de miniporto de exibição pode chamar para inspecionar e alterar o objeto de topologia VidPN.

Retornar valor

A função pfnGetTopology retorna um dos seguintes valores:

Código de retorno	Descrição
STATUS_SUCCESS	A função foi bem-sucedida.
STATUS_GRAPHICS_INVALID_VIDPN	O identificador fornecido no hVidPn era inválido.

Comentários

O driver de miniporto de exibição não precisa liberar o identificador que recebe em phVidPnTopology.

O tempo de vida da estrutura de DXGK_VIDPNTOPOLOGY_INTERFACE retornado em ppVidPnTopologyInterface pertence ao sistema operacional. Usando esse esquema de propriedade, o sistema operacional pode migrar para implementações mais recentes em tempo de execução sem interromper clientes da interface.

Requisitos

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

Confira também

DXGK_VIDPNTOPOLOGY_INTERFACE

Interface de topologia VidPN