Partilhar via


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

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

Sintaxe

DXGKDDI_VIDPNTARGETMODESET_RELEASEMODEINFO DxgkddiVidpntargetmodesetReleasemodeinfo;

NTSTATUS DxgkddiVidpntargetmodesetReleasemodeinfo(
  [in] IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [in] IN_CONST_PD3DKMDT_VIDPN_TARGET_MODE_CONST pVidPnTargetModeInfo
)
{...}

Parâmetros

[in] hVidPnTargetModeSet

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

[in] pVidPnTargetModeInfo

Um ponteiro para a estrutura D3DKMDT_VIDPN_TARGET_MODE que deve ser liberada.

Retornar valor

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_TARGETMODESET O identificador fornecido em hVidPnTargetModeSet era inválido.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET_MODE O ponteiro fornecido em pVidPnTargetModeInfo era inválido.

Comentários

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

Se você obtiver uma estrutura D3DKMDT_VIDPN_TARGET_MODE chamando pfnCreateNewModeInfo e passar essa estrutura para pfnAddMode, não será necessário liberar a estrutura.

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

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

pfnAcquireFirstModeInfo

pfnAcquireNextModeInfo

pfnAcquirePinnedModeInfo