DXGKDDI_VIDPN_RELEASESOURCEMODESET Rückruffunktion (d3dkmddi.h)

  • Artikel

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 Quellmodussatzobjekt enthält. Der VidPN-Manager hat dieses Handle zuvor für den Anzeigeminiporttreiber bereitgestellt, indem er DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn oder DxgkDdiRecommendFunctionalVidPn aufgerufen hat.

[in] hVidPnSourceModeSet

Der griff, der freigegeben werden soll.

Rückgabewert

Die PfnReleaseSourceModeSet-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_SOURCEMODESET Das in hVidPnSourceModeSet angegebene Handle war ungültig.
STATUS_GRAPHICS_RESOURCES_NOT_RELATED Der durch hVidPn identifizierte VidPN enthält nicht den Quellmodussatz, der von hVidPnSourceModeSet identifiziert wurde.

Hinweise

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

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 erhalten, indem Sie pfnCreateNewSourceModeSet aufrufen und dann entscheiden, den neuen Quellmodus nicht einer Quelle zuzuweisen, müssen Sie das neu abgerufene Handle freigeben, indem Sie pfnReleaseSourceModeSet aufrufen.

Die Datentypen D3DKMDT_HVIDPN und D3DKMDT_HVIDPNSOURCEMODESET 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

pfnAcquireSourceModeSet

pfnCreateNewSourceModeSet