Compartilhar via


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

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

Sintaxe

DXGKDDI_VIDPNSOURCEMODESET_RELEASEMODEINFO DxgkddiVidpnsourcemodesetReleasemodeinfo;

NTSTATUS DxgkddiVidpnsourcemodesetReleasemodeinfo(
  [in] IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [in] IN_CONST_PD3DKMDT_VIDPN_SOURCE_MODE_CONST pVidPnSourceModeInfo
)
{...}

Parâmetros

[in] hVidPnSourceModeSet

Um identificador para um objeto de conjunto de modo de origem VidPN. O driver de miniporto de exibição obteve esse identificador anteriormente chamando a função pfnAcquireSourceModeSet da interface DXGK_VIDPN_INTERFACE.

[in] pVidPnSourceModeInfo

Um ponteiro para a estrutura D3DKMDT_VIDPN_SOURCE_MODE que deve ser liberada.

Valor de retorno

A função pfnReleaseModeInfo retorna um dos seguintes valores:

Código de retorno Descrição
STATUS_SUCCESS A função foi bem-sucedida.
STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET O identificador fornecido em hVidPnSourceModeSet era inválido.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_SOURCE_MODE O ponteiro fornecido em pVidPnSourceModeInfo era inválido.

Observações

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

Se você obtiver uma estrutura de D3DKMDT_VIDPN_SOURCE_MODE chamando pfnCreateNewModeInfo e, em seguida, passar essa estrutura para pfnAddMode, você não precisará liberar a estrutura.

Se você obtiver um identificador chamando pfnCreateNewModeInfo e decidir não adicionar o novo modo a um conjunto de modo de origem, deverá liberar a estrutura recém-criada chamando pfnReleaseModeInfo.

O tipo de dados D3DKMDT_HVIDPNSOURCEMODESET é 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_SOURCE_MODE

pfnAcquireFirstModeInfo

pfnAcquireNextModeInfo

pfnAcquirePinnedModeInfo