Compartir a través de

Función CapabilitiesRequestAndCapabilitiesReply (lowlevelmonitorconfigurationapi.h)

  • Artículo

Advertencia

Las funciones de configuración del monitor físico funcionan con el estándar veSA Monitor Control Command Set (MCCS) a través de una interfaz I2C. Muchos monitores no implementan completamente ese estándar; por lo tanto, el uso de estos comandos podría dar lugar a un comportamiento de supervisión no definido. No se recomienda usar estas funciones para monitores arbitrarios sin validar físicamente que funcionan según lo previsto.

Recupera una cadena que describe las funcionalidades de un monitor.

Sintaxis

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

Parámetros

[in] hMonitor

Identificador de un monitor físico. Para obtener el identificador del monitor, llame a GetPhysicalMonitorsFromHMONITOR o GetPhysicalMonitorsFromIDirect3DDevice9.

[out] pszASCIICapabilitiesString

Puntero a un búfer que recibe la cadena de funcionalidades del monitor. El autor de la llamada debe asignar este búfer. Para obtener el tamaño de la cadena, llame a GetCapabilitiesStringLength. La cadena capabilities siempre es una cadena ASCII. El búfer debe incluir espacio para el carácter nulo de terminación.

[in] dwCapabilitiesStringLengthInCharacters

Tamaño de pszASCIICapabilitiesString en caracteres, incluido el carácter nulo de terminación.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es TRUE. Si se produce un error en la función, el valor devuelto es FALSE. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Esta función corresponde al comando "Capabilities Request & Capabilities Reply" del estándar Display Data Channel Command Interface (DDC/CI). Para obtener más información sobre la cadena de funcionalidades, consulte el estándar DDC/CI.

Esta función suele devolverse rápidamente, pero a veces puede tardar varios segundos en completarse.

Puede actualizar la cadena de funcionalidades de un monitor agregando una directiva AddReg al archivo INF del monitor. Agregue una clave del Registro denominada "CapabilitiesString" a la clave de controlador del monitor. El valor de la clave del Registro es la cadena de funcionalidades. El tipo de datos del Registro es REG_SZ.

HKR,,"CapabilitiesString",0x00000000,"updated capabilities string"
Advertencia No modifique el archivo INF de un monitor a menos que esté familiarizado con el diseño de los archivos INF y también comprenda el estándar DDC/CI.
 

Ejemplos


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 Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado lowlevelmonitorconfigurationapi.h
Library Dxva2.lib
Archivo DLL Dxva2.dll

Consulte también

Supervisar funciones de configuración