DXGKDDI_VIDPNTARGETMODESET_RELEASEMODEINFO Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

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

Syntax

DXGKDDI_VIDPNTARGETMODESET_RELEASEMODEINFO DxgkddiVidpntargetmodesetReleasemodeinfo;

NTSTATUS DxgkddiVidpntargetmodesetReleasemodeinfo(
  [in] IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [in] IN_CONST_PD3DKMDT_VIDPN_TARGET_MODE_CONST pVidPnTargetModeInfo
)
{...}

Parameter

[in] hVidPnTargetModeSet

Ein Handle für ein VidPN-Zielmodus-Set-Objekt. Der Display-Miniporttreiber hat dieses Handle zuvor durch Aufrufen der pfnAcquireTargetModeSet- Funktion der DXGK_VIDPN_INTERFACE Schnittstelle abgerufen.

[in] pVidPnTargetModeInfo

Ein Zeiger auf die D3DKMDT_VIDPN_TARGET_MODE Struktur, die losgelassen werden soll.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion war erfolgreich.
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET	Das in hVidPnTargetModeSet bereitgestellte Handle war ungültig.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET_MODE	Der in pVidPnTargetModeInfo bereitgestellte Zeiger war ungültig.

Bemerkungen

Wenn Sie mit der Verwendung einer D3DKMDT_VIDPN_TARGET_MODE Struktur fertig sind, die Sie durch Aufrufen einer der folgenden Funktionen erhalten haben, müssen Sie die Struktur freigeben, indem Sie pfnReleaseModeInfoaufrufen.

Wenn Sie eine D3DKMDT_VIDPN_TARGET_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 sich dann entscheiden, den neuen Modus nicht zu einem Zielmodussatz hinzuzufügen, müssen Sie die neu erstellte Struktur freigeben, indem Sie pfnReleaseModeInfoaufrufen.

Der D3DKMDT_HVIDPNSOURCEMODESET Datentyp wird in D3dkmdt.hdefiniert.