Função CapabilitiesRequestAndCapabilitiesReply (lowlevelmonitorconfigurationapi.h)

Aviso

As funções de configuração do monitor físico funcionam usando o padrão MCCS (Conjunto de Comandos de Controle) do VESA Monitor em uma interface I²C. Muitos monitores não implementam totalmente esse padrão; portanto, o uso desses comandos pode resultar em um comportamento de monitor indefinido. Não recomendamos usar essas funções para monitores arbitrários sem validar fisicamente que elas funcionam conforme o esperado.

Recupera uma cadeia de caracteres que descreve os recursos de um monitor.

Sintaxe

_BOOL CapabilitiesRequestAndCapabilitiesReply(
  [in]  HANDLE hMonitor,
  [out] LPSTR  pszASCIICapabilitiesString,
  [in]  DWORD  dwCapabilitiesStringLengthInCharacters
);

Parâmetros

[in] hMonitor

Manipule para um monitor físico. Para obter o identificador do monitor, chame GetPhysicalMonitorsFromHMONITOR ou GetPhysicalMonitorsFromIDirect3DDevice9.

[out] pszASCIICapabilitiesString

Ponteiro para um buffer que recebe a cadeia de caracteres de funcionalidades do monitor. O chamador deve alocar esse buffer. Para obter o tamanho da cadeia de caracteres, chame GetCapabilitiesStringLength. A cadeia de caracteres de funcionalidades é sempre uma cadeia de caracteres ASCII. O buffer deve incluir espaço para o caractere nulo de terminação.

[in] dwCapabilitiesStringLengthInCharacters

Tamanho de pszASCIICapabilitiesString em caracteres, incluindo o caractere nulo de terminação.

Retornar valor

Se a função for bem-sucedida, o valor retornado será TRUE. Se a função falhar, o valor retornado será FALSE. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Essa função corresponde ao comando "Solicitação de Recursos & Resposta de Funcionalidades" do padrão DDC/CI (Interface de Comando do Canal de Dados de Exibição). Para obter mais informações sobre a cadeia de caracteres de funcionalidades, consulte o padrão DDC/CI.

Essa função geralmente retorna rapidamente, mas às vezes pode levar vários segundos para ser concluída.

Você pode atualizar a cadeia de caracteres de funcionalidades de um monitor adicionando uma diretiva AddReg ao arquivo INF do monitor. Adicione uma chave do Registro chamada "CapabilitiesString" à chave de driver do monitor. O valor da chave do Registro é a cadeia de caracteres de funcionalidades. O tipo de dados do Registro é REG_SZ.

HKR,,"CapabilitiesString",0x00000000,"updated capabilities string"

Aviso Não modifique o arquivo INF de um monitor, a menos que você esteja familiarizado com o layout dos arquivos INF e também entenda o padrão DDC/CI.

 

Exemplos

DWORD cchStringLength = 0;
BOOL bSuccess = 0;
LPSTR szCapabilitiesString = NULL;

// Get the length of the string.
bSuccess = GetCapabilitiesStringLength(
   hPhysicalMonitor, // Handle to the monitor.
   &cchStringLength
   );

if (bSuccess)
{
    // Allocate the string buffer.
    LPSTR szCapabilitiesString = (LPSTR)malloc(cchStringLength);
    if (szCapabilitiesString != NULL)
    {
        // Get the capabilities string.
        bSuccess = CapabilitiesRequestAndCapabilitiesReply(
            hPhysicalMonitor,
            szCapabilitiesString,
            cchStringLength
            );

        // Free the string buffer.
        free(szCapabilitiesString);
    }
}

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]
Plataforma de Destino	Windows
Cabeçalho	lowlevelmonitorconfigurationapi.h
Biblioteca	Dxva2.lib
DLL	Dxva2.dll

Confira também

Monitorar funções de configuração