Partilhar via


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

A função pfnReleasePathInfo libera uma estrutura D3DKMDT_VIDPN_PRESENT_PATH que o gerenciador VidPN forneceu anteriormente para o driver de miniporto de exibição.

Sintaxe

DXGKDDI_VIDPNTOPOLOGY_RELEASEPATHINFO DxgkddiVidpntopologyReleasepathinfo;

NTSTATUS DxgkddiVidpntopologyReleasepathinfo(
  [in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in] IN_CONST_PD3DKMDT_VIDPN_PRESENT_PATH_CONST pVidPnPresentPathInfo
)
{...}

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 a estrutura D3DKMDT_VIDPN_PRESENT_PATH que deve ser liberada.

Valor de retorno

A função pfnReleasePathInfo 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_GRAPHICS_INVALID_VIDPN_PRESENT_PATH O ponteiro fornecido em pVidPnPresentPathInfo era inválido.

Observações

Quando terminar de usar uma estrutura de D3DKMDT_VIDPN_PRESENT_PATH obtida chamando qualquer uma das funções a seguir, você deverá liberar a estrutura chamando pfnReleasePathInfo.

Se você obtiver uma estrutura D3DKMDT_VIDPN_PRESENT_PATH chamando pfnCreateNewPathInfo e, em seguida, passar essa estrutura para pfnAddPath, você não precisará liberar a estrutura.

Se você obtiver um identificador chamando pfnCreateNewPathInfo e decidir não adicionar o novo caminho a uma topologia, deverá liberar a estrutura recém-criada chamando pfnReleasePathInfo.

O tipo de dados D3DKMDT_HVIDPNTOPOLOGY é definido em D3dkmdt.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

Consulte também

D3DKMDT_VIDPN_PRESENT_PATH

pfnAcqirePathInfo

pfnAcquireFirstPathInfo

pfnAcquireNextPathInfo