DXGKDDI_VIDPN_RELEASETARGETMODESET Rückruffunktion (d3dkmddi.h)

  • Artikel

Die pfnReleaseTargetModeSet-Funktion gibt ein Handle für ein Zielmodus-Setobjekt frei.

Syntax

DXGKDDI_VIDPN_RELEASETARGETMODESET DxgkddiVidpnReleasetargetmodeset;

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

Parameter

[in] hVidPn

Ein Handle für ein VidPN-Objekt, das das Zielmodus-Setobjekt enthält. Der VidPN-Manager hat dieses Handle zuvor für den Anzeigeminiporttreiber bereitgestellt, indem er DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn oder DxgkDdiRecommendFunctionalVidPn aufgerufen hat.

[in] hVidPnTargetModeSet

Der griff, der freigegeben werden soll.

Rückgabewert

Die PfnReleaseTargetModeSet-Funktion gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS Die Funktion wurde erfolgreich ausgeführt.
STATUS_GRAPHICS_INVALID_VIDPN Das in hVidPn angegebene Handle war ungültig.
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET Das in hVidPnTargetModeSet angegebene Handle war ungültig.
STATUS_GRAPHICS_RESOURCES_NOT_RELATED Der durch hVidPn identifizierte VidPN enthält nicht den Zielmodussatz, der von hVidPnTargetModeSet identifiziert wurde.

Hinweise

Wenn Sie die Verwendung eines Handles abgeschlossen haben, das Sie durch aufrufen von pfnAcquireTargetModeSet abgerufen haben, müssen Sie das Handle freigeben, indem Sie pfnReleaseTargetModeSet aufrufen.

Wenn Sie ein Handle abrufen, indem Sie pfnCreateNewTargetModeSet aufrufen und dieses Handle dann an pfnAssignTargetModeSet übergeben, müssen Sie das Handle nicht freigeben.

Wenn Sie ein Handle erhalten, indem Sie pfnCreateNewTargetModeSet aufrufen und dann entscheiden, den neuen Quellmodussatz nicht einer Quelle zuzuweisen, müssen Sie das neu abgerufene Handle freigeben, indem Sie pfnReleaseTargetModeSet aufrufen.

Die Datentypen D3DKMDT_HVIDPN und D3DKMDT_HVIDPNTARGETMODESET werden in D3dkmdt.h definiert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Zielplattform Desktop
Kopfzeile d3dkmddi.h (einschließlich D3dkmddi.h)
IRQL PASSIVE_LEVEL

Weitere Informationen

pfnAcquireTargetModeSet

pfnCreateNewTargetModeSet