Функция CapabilitiesRequestAndCapabilitiesReply (lowlevelmonitorconfigurationapi.h)

Статья
01/10/2024

Предупреждение

Функции конфигурации физического монитора работают с использованием стандарта НАБОРА команд управления монитором VESA (MCCS) через интерфейс I²C. Многие мониторы не полностью реализуют этот стандарт; поэтому использование этих команд может привести к неопределенному поведению монитора. Мы не рекомендуем использовать эти функции для произвольных мониторов без физической проверки их работы.

Извлекает строку, описывающую возможности монитора.

Синтаксис

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

Параметры

[in] hMonitor

Обработка на физическом мониторе. Чтобы получить дескриптор монитора, вызовите Метод GetPhysicalMonitorsFromHMONITOR или GetPhysicalMonitorsFromIDirect3Device9.

[out] pszASCIICapabilitiesString

Указатель на буфер, который получает строку возможностей монитора. Вызывающий объект должен выделить этот буфер. Чтобы получить размер строки, вызовите Метод GetCapabilitiesStringLength. Строка возможностей всегда является строкой ASCII. Буфер должен содержать пробел для завершающего символа NULL.

[in] dwCapabilitiesStringLengthInCharacters

Размер pszASCIICapabilitiesString в символах, включая завершающий символ NULL.

Возвращаемое значение

Если функция выполняется успешно, возвращается значение TRUE. Если функция завершается сбоем, возвращается значение FALSE. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Эта функция соответствует команде "Capabilities Request & Capabilities Reply" из стандарта Display Data Channel Command Interface (DDC/CI). Дополнительные сведения о строке возможностей см. в статье Стандарт DDC/CI.

Обычно эта функция возвращается быстро, но иногда выполнение может занять несколько секунд.

Вы можете обновить строку возможностей монитора, добавив директиву AddReg в INF-файл монитора. Добавьте раздел реестра с именем CapabilitiesString в раздел драйвера монитора. Значением раздела реестра является строка возможностей. Тип данных реестра — REG_SZ.

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

Предупреждение Не изменяйте INF-файл монитора, если вы не знакомы с макетом INF-файлов и не понимаете стандарт DDC/CI.

Примеры


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);
    }
}

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	lowlevelmonitorconfigurationapi.h
Библиотека	Dxva2.lib
DLL	Dxva2.dll

См. также раздел

Мониторинг функций конфигурации