DXGKDDI_VIDPNTOPOLOGY_ADDPATH função de retorno de chamada (d3dkmddi.h)
A função pfnAddPath adiciona um caminho de vídeo presente a um objeto de topologia VidPN especificado.
Sintaxe
DXGKDDI_VIDPNTOPOLOGY_ADDPATH DxgkddiVidpntopologyAddpath;
NTSTATUS DxgkddiVidpntopologyAddpath(
[in] IN_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
[in] IN_PD3DKMDT_VIDPN_PRESENT_PATH pVidPnPresentPath
)
{...}
Parâmetros
[in] hVidPnTopology
Um identificador para um objeto de topologia VidPN. O driver de miniporta de exibição obteve esse identificador anteriormente chamando a função pfnGetTopology da interface DXGK_VIDPN_INTERFACE .
[in] pVidPnPresentPath
Um ponteiro para uma estrutura D3DKMDT_VIDPN_PRESENT_PATH que descreve o caminho. O driver de miniporto de exibição obteve anteriormente esse ponteiro chamando pfnCreateNewPathInfo.
Retornar valor
A função pfnAddPath 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. |
| STATUS_ACCESS_DENIED | O caminho não pode ser removido no contexto da chamada DDI atual. |
Comentários
Para adicionar um caminho a uma topologia, o driver de miniporta de exibição executa as etapas a seguir.
Chame pfnCreateNewPathInfo para obter um ponteiro para uma estrutura D3DKMDT_VIDPN_PRESENT_PATH alocada pelo gerenciador VidPN.
Preencha a estrutura D3DKMDT_VIDPN_PRESENT_PATH com informações sobre o caminho, incluindo identificadores de origem e de destino presentes no vídeo.
Chame pfnAddPath para adicionar o caminho a uma topologia.
O gerenciador VidPN aloca uma estrutura D3DKMDT_VIDPN_PRESENT_PATH quando você chama pfnCreateNewPathInfo. Se você adicionar o caminho descrito por essa estrutura a uma topologia, não será necessário liberar explicitamente a estrutura; pfnAddPath o libera.
Se você obtiver uma estrutura D3DKMDT_VIDPN_PRESENT_PATH chamando pfnCreateNewPathInfo e decidir não adicionar esse caminho a uma topologia, deverá liberar explicitamente a estrutura chamando pfnReleasePathInfo.
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 |