DXGKDDI_VIDPNTOPOLOGY_ADDPATH função de retorno de chamada (d3dkmddi.h)
A função pfnAddPath adiciona um caminho de apresentação de vídeo 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 miniporto 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 esse ponteiro anteriormente chamando pfnCreateNewPathInfo.
Valor de retorno
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. |
Observações
Para adicionar um caminho a uma topologia, o driver de miniporto de exibição executa as etapas a seguir.
Chame pfnCreateNewPathInfo para obter um ponteiro para uma estrutura de D3DKMDT_VIDPN_PRESENT_PATH alocada pelo gerenciador VidPN.
Preencha a estrutura D3DKMDT_VIDPN_PRESENT_PATH com informações sobre o caminho, incluindo os 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 de D3DKMDT_VIDPN_PRESENT_PATH quando você chama pfnCreateNewPathInfo. Se você adicionar o caminho descrito por essa estrutura a uma topologia, você não precisará 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, você deverá liberar explicitamente a estrutura chamando pfnReleasePathInfo.
O tipo de dados D3DKMDT_HVIDPNTOPOLOGY é definido emD3dkmdt.h.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dkmddi.h (inclua D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |