GetPhysicalMonitors, fonction

Article
06/13/2023

Important

Cette fonction est utilisée par l’API de configuration du moniteur pour accéder aux fonctionnalités du pilote d’affichage. Les applications ne doivent pas appeler cette fonction.

Obtient les moniteurs physiques associés à un périphérique d’affichage.

Syntaxe

NTSTATUS WINAPI GetPhysicalMonitors(
  _In_  UNICODE_STRING *pstrDeviceName,
  _In_  DWORD          dwPhysicalMonitorArraySize,
  _Out_ DWORD          *pdwNumPhysicalMonitorHandlesInArray,
  _Out_ HANDLE         *phPhysicalMonitorArray
);

Paramètres

pstrDeviceName [in]: Pointeur vers une structure de UNICODE_STRING qui contient le nom de l’appareil d’affichage, comme retourné par la fonction GetMonitorInfo .
dwPhysicalMonitorArraySize [in]: Nombre d’éléments dans le tableau pdwNumPhysicalMonitorHandlesInArray . Pour obtenir la taille requise du tableau, appelez GetNumberOfPhysicalMonitors.
pdwNumPhysicalMonitorHandlesInArray [out]: Reçoit le nombre d’éléments que la fonction copie dans le tableau phPhysicalMonitorArray .
phPhysicalMonitorArray [out]: Tableau qui reçoit des handles aux moniteurs physiques. Chaque handle doit être libéré en appelant DestroyPhysicalMonitor.

Valeur retournée

Si la méthode réussit, elle retourne STATUS_SUCCESS. Sinon, il retourne un code d’erreur NTSTATUS .

Notes

Au lieu d’utiliser cette fonction, les applications doivent appeler l’une des fonctions suivantes :

Cette fonction n’a pas de bibliothèque d’importation associée. Pour appeler cette fonction, vous devez utiliser les fonctions LoadLibrary et GetProcAddress pour lier dynamiquement à Gdi32.dll.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
DLL	Gdi32.dll

Voir aussi

Surveiller les fonctions de configuration

Partager via