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 gerente do VidPN anteriormente forneceu esse identificador para o driver de miniport de exibição chamando DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPnou DxgkDdiRecommendFunctionalVidPn.
[in] hVidPnTargetModeSet
O identificador a ser liberado.
Valor de retorno
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 pelo hVidPn não contém o conjunto de modo de destino identificado por hVidPnTargetModeSet. |
Observações
Quando terminar de usar um identificador obtido chamando pfnAcquireTargetModeSet, você deverá liberar o identificador chamando pfnReleaseTargetModeSet.
Se você obter um identificador chamando pfnCreateNewTargetModeSet e, em seguida, passar esse identificador para pfnAssignTargetModeSet, você não precisará liberar o identificador.
Se você obtiver um identificador chamando pfnCreateNewTargetModeSet e decidir não atribuir o novo modo de origem definido a uma origem, 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 |
|---|---|
| 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 |