Função GetPhysicalMonitors

Importante

Essa função é usada pela API de configuração do monitor para acessar a funcionalidade no driver de exibição. Os aplicativos não devem chamar essa função.

Obtém os monitores físicos associados a um dispositivo de exibição.

Sintaxe

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

Parâmetros

pstrDeviceName [in]

Um ponteiro para uma estrutura UNICODE_STRING que contém o nome do dispositivo de exibição, conforme retornado pela função GetMonitorInfo .

dwPhysicalMonitorArraySize [in]

O número de elementos na matriz pdwNumPhysicalMonitorHandlesInArray . Para obter o tamanho necessário da matriz, chame GetNumberOfPhysicalMonitors.

pdwNumPhysicalMonitorHandlesInArray [out]

Recebe o número de itens que a função copia para a matriz phPhysicalMonitorArray .

phPhysicalMonitorArray [out]

Uma matriz que recebe identificadores para os monitores físicos. Cada identificador deve ser liberado chamando DestroyPhysicalMonitor.

Valor retornado

Se o método for bem-sucedido, ele retornará STATUS_SUCCESS. Caso contrário, ele retornará um código de erro NTSTATUS .

Comentários

Em vez de usar essa função, os aplicativos devem chamar uma das seguintes funções:

• GetPhysicalMonitorsFromHMONITOR
• GetPhysicalMonitorsFromIDirect3DDevice9

Essa função não tem nenhuma biblioteca de importação associada. Para chamar essa função, você deve usar as funções LoadLibrary e GetProcAddress para vincular dinamicamente a Gdi32.dll.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
DLL	Gdi32.dll

Confira também

Monitorar funções de configuração