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

  • Artigo

A função pfnReleaseTargetModeSet libera um identificador para um objeto de conjunto de modo de destino.

Sintaxe

DXGKDDI_VIDPN_RELEASETARGETMODESET DxgkddiVidpnReleasetargetmodeset;

NTSTATUS DxgkddiVidpnReleasetargetmodeset(
  [in] IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in] IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet
)
{...}

Parâmetros

[in] hVidPn

Um identificador para um objeto VidPN que contém o objeto de conjunto de modo de destino. O gerenciador VidPN forneceu anteriormente esse identificador para o driver de miniporto de exibição chamando DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn ou DxgkDdiRecommendFunctionalVidPn.

[in] hVidPnTargetModeSet

O identificador a ser liberado.

Retornar valor

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

Código de retorno Descrição
STATUS_SUCCESS A função foi bem-sucedida.
STATUS_GRAPHICS_INVALID_VIDPN O identificador fornecido no hVidPn era inválido.
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET O identificador fornecido em hVidPnTargetModeSet era inválido.
STATUS_GRAPHICS_RESOURCES_NOT_RELATED O VidPN identificado por hVidPn não contém o conjunto de modo de destino identificado por hVidPnTargetModeSet.

Comentários

Quando terminar de usar um identificador obtido chamando pfnAcquireTargetModeSet, você deverá liberar o identificador chamando pfnReleaseTargetModeSet.

Se você obtiver um identificador chamando pfnCreateNewTargetModeSet e passar esse identificador para pfnAssignTargetModeSet, não será necessário liberar o identificador.

Se você obtiver um identificador chamando pfnCreateNewTargetModeSet e decidir não atribuir o novo modo de origem definido a uma fonte, deverá liberar o identificador recém-obtido chamando pfnReleaseTargetModeSet.

Os tipos de dados D3DKMDT_HVIDPN e D3DKMDT_HVIDPNTARGETMODESET são definidos 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

pfnAcquireTargetModeSet

pfnCreateNewTargetModeSet