Função GetPhysicalMonitorDescription

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 uma descrição de um monitor físico.

Sintaxe

NTSTATUS WINAPI GetPhysicalMonitorDescription(
  _In_  HANDLE hMonitor,
  _In_  DWORD  dwPhysicalMonitorDescriptionSizeInChars,
  _Out_ LPWSTR szPhysicalMonitorDescription
);

Parâmetros

hMonitor [in]

Um identificador para um monitor físico.

dwPhysicalMonitorDescriptionSizeInChars [in]

O número de caracteres na matriz szPhysicalMonitorDescription .

szPhysicalMonitorDescription [out]

Um ponteiro para uma matriz que recebe a descrição. O número de elementos na matriz deve ser pelo menos PHYSICAL_MONITOR_DESCRIPTION_SIZE.

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 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