D3DKMTInvalidateActiveVidPn, fonction (d3dkmthk.h)
La fonction D3DKMTInvalidateActiveVidPn invalide le réseau vidéo présent actif (VidPN) actuellement utilisé.
Notes
Cette fonction est obsolète dans Windows 7 et les versions ultérieures des systèmes d’exploitation Windows.
Syntaxe
NTSTATUS D3DKMTInvalidateActiveVidPn(
[in] const D3DKMT_INVALIDATEACTIVEVIDPN *unnamedParam1
);
Paramètres
[in] unnamedParam1
Pointeur vers une structure de D3DKMT_INVALIDATEACTIVEVIDPN qui décrit les paramètres qui invalident le VidPN actif en cours d’utilisation.
Valeur retournée
D3DKMTInvalidateActiveVidPn retourne l’une des valeurs suivantes :
| Code de retour | Description |
|---|---|
| STATUS_SUCCESS | Le VidPN actuellement utilisé a été invalidé. |
| STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER | Aucune carte graphique n’a été spécifiée dans le membre hAdapter de D3DKMT_INVALIDATEACTIVEVIDPN pour invalider le VidPN. |
| STATUS_NO_MEMORY | D3DKMTInvalidateActiveVidPn n’a pas pu se terminer en raison d’une mémoire insuffisante. |
| STATUS_NOT_SUPPORTED | Le mode d’affichage demandé par le pilote client installable OpenGL (ICD) dans la mémoire tampon pointée par le membre pPrivateDriverData de D3DKMT_INVALIDATEACTIVEVIDPN n’est pas pris en charge par le pilote miniport d’affichage. Cette valeur status est également retournée si cette fonction est appelée sur un ordinateur exécutant Windows 7 et versions ultérieures par un pilote de miniport d’affichage avec DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN7. |
| STATUS_DEVICE_REMOVED | La carte graphique a été arrêtée. |
| STATUS_GRAPHICS_NO_RECOMMENDED_FUNCTIONAL_VIDPN | Le pilote de miniport d’affichage n’a pas recommandé un VidPN pour remplacer le VidPN actuellement utilisé. |
Cette fonction peut également retourner d’autres valeurs NTSTATUS .
Remarques
Lorsque la fonction D3DKMTInvalidateActiveVidPn est appelée pour invalider le VidPN en cours d’utilisation, le VidPN actuel est remplacé par un nouveau VidPN recommandé par le pilote de miniport d’affichage. Étant donné que le pilote de miniport d’affichage doit recommander un nouveau VidPN, le pilote miniport d’affichage doit être en mesure de déterminer le mode d’affichage requis par openGL ICD à partir de la mémoire tampon vers laquelle pointe le membre pPrivateDriverData de D3DKMT_INVALIDATEACTIVEVIDPN.
OpenGL ICD peut appeler D3DKMTInvalidateActiveVidPn pour les modes d’affichage (par exemple, mode d’affichage de clone) qui ne sont pas pris en charge à l’aide de l’appel plus général à la fonction D3DKMTSetDisplayMode .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows pour les pilotes miniport d’affichage avec version < DXGKDDI_INTERFACE_VERSION_WIN7. |
| Plateforme cible | Universal |
| En-tête | d3dkmthk.h (include D3dkmthk.h) |
| Bibliothèque | Gdi32.lib |
| DLL | Gdi32.dll |