DXGKDDI_VIDPN_RELEASESOURCEMODESET Rückruffunktion (d3dkmddi.h)
Die pfnReleaseSourceModeSet--Funktion gibt ein Handle für ein Quellmodussatzobjekt frei.
Syntax
DXGKDDI_VIDPN_RELEASESOURCEMODESET DxgkddiVidpnReleasesourcemodeset;
NTSTATUS DxgkddiVidpnReleasesourcemodeset(
[in] IN_CONST_D3DKMDT_HVIDPN hVidPn,
[in] IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet
)
{...}
Parameter
[in] hVidPn
Ein Handle für das VidPN-Objekt, das das Objekt für den Quellmodussatz enthält. Der VidPN-Manager hat diesem Handle zuvor den Miniporttreiber angezeigt, indem er DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPnoder DxgkDdiRecommendFunctionalVidPnaufruft.
[in] hVidPnSourceModeSet
Der zu veröffentlichende Ziehpunkt.
Rückgabewert
Die funktion pfnReleaseSourceModeSet 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_SOURCEMODESET | Das in hVidPnSourceModeSet bereitgestellte Handle war ungültig. |
| STATUS_GRAPHICS_RESOURCES_NOT_RELATED | Der von hVidPn identifizierte VidPN enthält nicht den durch hVidPnSourceModeSet identifizierten Quellmodus. |
Bemerkungen
Wenn Sie mit der Verwendung eines Handles fertig sind, das Sie durch Aufrufen pfnAcquireSourceModeSeterhalten haben, müssen Sie das Handle durch Aufrufen pfnReleaseSourceModeSetfreigeben.
Wenn Sie ein Handle abrufen, indem Sie pfnCreateNewSourceModeSet aufrufen und dieses Handle dann an pfnAssignSourceModeSetübergeben, müssen Sie das Handle nicht freigeben.
Wenn Sie ein Handle durch Aufrufen pfnCreateNewSourceModeSet abrufen und sich dann entscheiden, den neuen Quellmodus einer Quelle nicht zuzuweisen, müssen Sie das neu abgerufene Handle freigeben, indem Sie pfnReleaseSourceModeSetaufrufen.
Die Datentypen D3DKMDT_HVIDPN und D3DKMDT_HVIDPNSOURCEMODESET 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 |