Compartilhar via


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

A função pfnAcquireNextPathInfo retorna um descritor do próximo caminho de vídeo presente em uma topologia VidPN especificada, dado o caminho atual.

Sintaxe

DXGKDDI_VIDPNTOPOLOGY_ACQUIRENEXTPATHINFO DxgkddiVidpntopologyAcquirenextpathinfo;

NTSTATUS DxgkddiVidpntopologyAcquirenextpathinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in]  IN_CONST_PD3DKMDT_VIDPN_PRESENT_PATH_CONST pVidPnPresentPathInfo,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_PRESENT_PATH ppNextVidPnPresentPathInfo
)
{...}

Parâmetros

[in] hVidPnTopology

Um identificador para um objeto de topologia VidPN. O driver de miniporto de exibição obteve esse identificador anteriormente chamando a função pfnGetTopology da interface DXGK_VIDPN_INTERFACE .

[in] pVidPnPresentPathInfo

Um ponteiro para uma estrutura D3DKMDT_VIDPN_PRESENT_PATH que descreve o caminho atual. O driver de miniporte de exibição obteve esse ponteiro anteriormente chamando pfnAcquireFirstPathInfo ou pfnAcquireNextPathInfo.

[out] ppNextVidPnPresentPathInfo

Um ponteiro para uma variável que recebe um ponteiro para uma estrutura D3DKMDT_VIDPN_PRESENT_PATH que descreve o próximo caminho.

Retornar valor

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

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

Comentários

Quando terminar de usar a estrutura D3DKMDT_VIDPN_PRESENT_PATH, você deverá liberar a estrutura chamando pfnReleasePathInfo.

Você pode enumerar todos os caminhos que pertencem a um objeto de topologia VidPN chamando pfnAcquireFirstPathInfo e, em seguida, fazendo uma sequência de chamadas para pfnAcquireNextPathInfo.

O tipo de dados D3DKMDT_HVIDPNTOPOLOGY é definido em D3dkmdt.h.

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

D3DKMDT_VIDPN_PRESENT_PATH

pfnAcqirePathInfo

pfnAcquireFirstPathInfo

pfnReleasePathInfo