D3DKMTInvalidateActiveVidPn-Funktion (d3dkmthk.h)

  • Artikel

Mit der Funktion D3DKMTInvalidateActiveVidPn wird das aktive video present network (VidPN) ungültig, das derzeit verwendet wird.

Hinweis

Diese Funktion ist in Windows 7 und höheren Versionen von Windows-Betriebssystemen veraltet.

Syntax

NTSTATUS D3DKMTInvalidateActiveVidPn(
  [in] const D3DKMT_INVALIDATEACTIVEVIDPN *unnamedParam1
);

Parameter

[in] unnamedParam1

Ein Zeiger auf eine D3DKMT_INVALIDATEACTIVEVIDPN-Struktur , die Parameter beschreibt, die die derzeit verwendete aktive VidPN ungültig machen.

Rückgabewert

D3DKMTInvalidateActiveVidPn gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS Die derzeit verwendete VidPN wurde erfolgreich ungültig.
STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER Im hAdapter-Member von D3DKMT_INVALIDATEACTIVEVIDPN , für den die VidPN ungültig wird, wurde kein Grafikkarte angegeben.
STATUS_NO_MEMORY D3DKMTInvalidateActiveVidPn konnte aufgrund von unzureichendem Arbeitsspeicher nicht abgeschlossen werden.
STATUS_NOT_SUPPORTED Der Anzeigemodus, der vom openGL Installable Client Driver (ICD) im Puffer angefordert wird, auf den das pPrivateDriverData-Element von D3DKMT_INVALIDATEACTIVEVIDPN verweist, wird vom Display-Miniporttreiber nicht unterstützt. Dieser status Wert wird auch zurückgegeben, wenn diese Funktion auf einem Computer unter Windows 7 und höher von einem Display-Miniporttreiber mit DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN7 aufgerufen wird.
STATUS_DEVICE_REMOVED Die Grafikkarte wurde beendet.
STATUS_GRAPHICS_NO_RECOMMENDED_FUNCTIONAL_VIDPN Der Display-Miniporttreiber hat keine VidPN empfohlen, um die derzeit verwendete VidPN zu ersetzen.

Diese Funktion gibt möglicherweise auch andere NTSTATUS-Werte zurück.

Hinweise

Wenn die Funktion D3DKMTInvalidateActiveVidPn aufgerufen wird, um die derzeit verwendete VidPN für ungültig zu erklären, wird die aktuelle VidPN durch eine neue VidPN ersetzt, die vom Anzeigeminiporttreiber empfohlen wird. Da der Anzeigeminiporttreiber eine neue VidPN empfehlen muss, muss der Anzeige-Miniporttreiber in der Lage sein, den Anzeigemodus zu bestimmen, den die OpenGL ICD über den Puffer benötigt, auf den das pPrivateDriverData-Element von D3DKMT_INVALIDATEACTIVEVIDPN zeigt.

Die OpenGL ICD kann D3DKMTInvalidateActiveVidPn für Anzeigemodi (z. B. Klonansichtsmodus) aufrufen, die nicht mithilfe des allgemeineren Aufrufs der Funktion D3DKMTSetDisplayMode unterstützt werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme für Display-Miniport-Treiber mit Version < DXGKDDI_INTERFACE_VERSION_WIN7.
Zielplattform Universell
Header d3dkmthk.h (include D3dkmthk.h)
Bibliothek Gdi32.lib
DLL Gdi32.dll

Weitere Informationen

D3DKMTSetDisplayMode

D3DKMT_INVALIDATEACTIVEVIDPN