DXGKDDI_VIDPN_RELEASETARGETMODESET Rückruffunktion (d3dkmddi.h)
Die pfnReleaseTargetModeSet--Funktion gibt ein Handle für ein Zielmodussatzobjekt 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 zu einem VidPN-Objekt, das das Zielmodussatzobjekt enthält. Der VidPN-Manager hat diesem Handle zuvor den Miniporttreiber angezeigt, indem er DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPnoder DxgkDdiRecommendFunctionalVidPnaufruft.
[in] hVidPnTargetModeSet
Der zu veröffentlichende Ziehpunkt.
Rückgabewert
Die pfnReleaseTargetModeSet Funktion gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | Die Funktion war erfolgreich. |
| STATUS_GRAPHICS_INVALID_VIDPN | Der in hVidPn bereitgestellte Handle war ungültig. |
| STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET | Das in hVidPnTargetModeSet bereitgestellte Handle war ungültig. |
| STATUS_GRAPHICS_RESOURCES_NOT_RELATED | Der von hVidPn identifizierte VidPN enthält nicht den von hVidPnTargetModeSet identifizierten Zielmodus. |
Bemerkungen
Wenn Sie mit der Verwendung eines Handles fertig sind, das Sie durch Aufrufen pfnAcquireTargetModeSetabgerufen haben, müssen Sie das Handle durch Aufrufen pfnReleaseTargetModeSetfreigeben.
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 durch Aufrufen pfnCreateNewTargetModeSet abrufen und sich dann entscheiden, den neuen Quellmodus einer Quelle nicht zuzuweisen, müssen Sie das neu abgerufene Handle freigeben, indem Sie pfnReleaseTargetModeSetaufrufen.
Die Datentypen D3DKMDT_HVIDPN und D3DKMDT_HVIDPNTARGETMODESET werden in D3dkmdt.hdefiniert.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| Zielplattform- | Desktop |
| Header- | d3dkmddi.h (einschließlich D3dkmddi.h) |
| IRQL- | PASSIVE_LEVEL |