D3DKMTInvalidateActiveVidPn-Funktion (d3dkmthk.h)
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 |