DXGKDDI_VIDPNTOPOLOGY_ACQUIREPATHINFO função de retorno de chamada (d3dkmddi.h)
A função pfnAcquirePathInfo retorna um descritor do caminho de apresentação do vídeo especificado por uma fonte presente do vídeo e um destino de vídeo presente em uma topologia VidPN específica.
Sintaxe
DXGKDDI_VIDPNTOPOLOGY_ACQUIREPATHINFO DxgkddiVidpntopologyAcquirepathinfo;
NTSTATUS DxgkddiVidpntopologyAcquirepathinfo(
[in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
[out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_PRESENT_PATH ppVidPnPresentPathInfo
)
{...}
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] VidPnSourceId
Um inteiro que identifica uma fonte presente do vídeo.
[in] VidPnTargetId
Um inteiro que identifica um destino de vídeo presente.
[out] ppVidPnPresentPathInfo
Um ponteiro para uma variável que recebe um ponteiro para uma estrutura D3DKMDT_VIDPN_PRESENT_PATH que descreve o caminho solicitado.
Retornar valor
A função pfnAcquirePathInfo 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.
Um caminho contém um par (origem, destino) e uma topologia é uma coleção de caminhos. Essa função retorna um descritor para o caminho, em uma topologia especificada, que contém um par especificado (origem, destino).
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.
Os identificadores de origem VidPN são atribuídos pelo sistema operacional. DxgkDdiStartDevice, implementado pelo driver de miniporto de exibição, retorna o número N de fontes presentes de vídeo compatíveis com o adaptador de exibição. Em seguida, o sistema operacional atribui identificadores 0, 1, 2, ... N - 1.
Os identificadores de destino VidPN são atribuídos pelo driver de miniporto de exibição. DxgkDdiQueryChildRelations, implementado pelo driver de miniporto de exibição, retorna uma matriz de estruturas DXGK_CHILD_DESCRIPTOR , cada uma contendo um identificador.
O tipo de dados D3DKMDT_HVIDPNTOPOLOGY é definido em D3dkmdt.h.
Os tipos de dados D3DDDI_VIDEO_PRESENT_SOURCE_ID e D3DDDI_VIDEO_PRESENT_TARGET_ID são definidos em D3dukmdt.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 |