DXGKDDI_VIDPNTARGETMODESET_RELEASEMODEINFO Rückruffunktion (d3dkmddi.h)
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-Setobjekt. Der Anzeigeminiporttreiber 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 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_TARGETMODESET | Das in hVidPnTargetModeSet angegebene Handle war ungültig. |
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET_MODE | Der in pVidPnTargetModeInfo angegebene Zeiger war ungültig. |
Hinweise
Wenn Sie die Verwendung einer D3DKMDT_VIDPN_TARGET_MODE-Struktur abgeschlossen haben, die Sie durch Aufrufen einer der folgenden Funktionen erhalten haben, müssen Sie die Struktur freigeben, indem Sie pfnReleaseModeInfo aufrufen.
Wenn Sie eine D3DKMDT_VIDPN_TARGET_MODE-Struktur erhalten, indem Sie pfnCreateNewModeInfo aufrufen und diese Struktur dann an pfnAddMode übergeben, müssen Sie die Struktur nicht freigeben.Wenn Sie einen Handle erhalten, indem Sie pfnCreateNewModeInfo aufrufen und dann entscheiden, den neuen Modus nicht zu einem Zielmodussatz 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 |