DXGKDDI_VIDPNSOURCEMODESET_RELEASEMODEINFO Rückruffunktion (d3dkmddi.h)

Die pfnReleaseModeInfo-Funktion gibt eine D3DKMDT_VIDPN_SOURCE_MODE-Struktur frei, die der VidPN-Manager zuvor für den Anzeige-Miniporttreiber bereitgestellt hat.

Syntax

DXGKDDI_VIDPNSOURCEMODESET_RELEASEMODEINFO DxgkddiVidpnsourcemodesetReleasemodeinfo;

NTSTATUS DxgkddiVidpnsourcemodesetReleasemodeinfo(
  [in] IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [in] IN_CONST_PD3DKMDT_VIDPN_SOURCE_MODE_CONST pVidPnSourceModeInfo
)
{...}

Parameter

[in] hVidPnSourceModeSet

Ein Handle für ein VidPN-Quellmodus-Set-Objekt. Der Anzeige-Miniporttreiber hat dieses Handle zuvor durch Aufrufen der pfnAcquireSourceModeSet-Funktion der DXGK_VIDPN_INTERFACE-Schnittstelle abgerufen.

[in] pVidPnSourceModeInfo

Ein Zeiger auf die D3DKMDT_VIDPN_SOURCE_MODE Struktur, die freigegeben werden soll.

Rückgabewert

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

Rückgabecode Beschreibung
STATUS_SUCCESS Die Funktion wurde erfolgreich ausgeführt.
STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET Das in hVidPnSourceModeSet angegebene Handle war ungültig.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_SOURCE_MODE Der in pVidPnSourceModeInfo angegebene Zeiger war ungültig.

Hinweise

Wenn Sie die Verwendung einer D3DKMDT_VIDPN_SOURCE_MODE-Struktur abgeschlossen haben, die Sie durch Aufrufen einer der folgenden Funktionen abgerufen haben, müssen Sie die -Struktur freigeben, indem Sie pfnReleaseModeInfo aufrufen.

Wenn Sie eine D3DKMDT_VIDPN_SOURCE_MODE Struktur abrufen, indem Sie pfnCreateNewModeInfo aufrufen und diese Struktur dann an pfnAddMode übergeben, müssen Sie die -Struktur nicht freigeben.

Wenn Sie ein Handle durch Aufrufen von pfnCreateNewModeInfo abrufen und dann entscheiden, den neuen Modus nicht zu einer Quellmodusmenge hinzuzufügen, müssen Sie die neu erstellte Struktur freigeben, indem Sie pfnReleaseModeInfo aufrufen.

Der D3DKMDT_HVIDPNSOURCEMODESET Datentyp ist 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

D3DKMDT_VIDPN_SOURCE_MODE

pfnAcquireFirstModeInfo

pfnAcquireNextModeInfo

pfnAcquirePinnedModeInfo