Compartilhar via

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

  • Artigo

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

Confira também

D3DKMDT_VIDPN_PRESENT_PATH

pfnCreateNewPathInfo

pfnReleasePathInfo