DXGKDDI_VIDPN_RELEASETARGETMODESET função de retorno de chamada (d3dkmddi.h)
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 |