Funzione GetPhysicalMonitors

Articolo
06/13/2023

Importante

Questa funzione viene usata dall'API di configurazione di monitoraggio per accedere alle funzionalità nel driver di visualizzazione. Le applicazioni non devono chiamare questa funzione.

Ottiene i monitor fisici associati a un dispositivo di visualizzazione.

Sintassi

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

Parametri

pstrDeviceName [in]: Puntatore a una struttura UNICODE_STRING contenente il nome del dispositivo visualizzato, come restituito dalla funzione GetMonitorInfo .
dwPhysicalMonitorArraySize [in]: Numero di elementi nella matrice pdwNumPhysicalMonitorHandlesInArray . Per ottenere le dimensioni necessarie della matrice, chiamare GetNumberOfPhysicalMonitors.
pdwNumPhysicalMonitorHandlesInArray [out]: Riceve il numero di elementi copiati dalla funzione nella matrice phPhysicalMonitorArray .
phPhysicalMonitorArray [out]: Matrice che riceve handle per i monitor fisici. Ogni handle deve essere rilasciato chiamando DestroyPhysicalMonitor.

Valore restituito

Se il metodo ha esito positivo, restituisce STATUS_SUCCESS. In caso contrario, restituisce un codice di errore NTSTATUS .

Commenti

Anziché usare questa funzione, le applicazioni devono chiamare una delle funzioni seguenti:

Questa funzione non ha alcuna libreria di importazione associata. Per chiamare questa funzione, è necessario usare le funzioni LoadLibrary e GetProcAddress per collegare dinamicamente a Gdi32.dll.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
DLL	Gdi32.dll

Vedi anche

Monitorare le funzioni di configurazione

Condividi tramite