DXGKDDI_VIDPN_RELEASETARGETMODESET Rückruffunktion (d3dkmddi.h)
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 |