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 |