通过

CapabilitiesRequestAndCapabilitiesReply 函数 (lowlevelmonitorconfigurationapi.h)

  • 项目

警告

物理监视器配置功能通过 I2C 接口使用 VESA 监视器控制命令集 (MCCS) 标准。 许多监视器未完全实现该标准;因此，使用这些命令可能会导致未定义的监视器行为。 在未对任意监视器进行物理验证的情况下，不建议将这些函数用于任意监视器，因为它们是否按预期工作。

检索描述监视器功能的字符串。

语法

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

参数

[in] hMonitor

物理监视器的句柄。 若要获取监视器句柄，请调用 GetPhysicalMonitorsFromHMONITOR 或 GetPhysicalMonitorsFromIDirect3DDevice9。

[out] pszASCIICapabilitiesString

指向接收监视器功能字符串的缓冲区的指针。 调用方必须分配此缓冲区。 若要获取字符串的大小，请调用 GetCapabilitiesStringLength。 功能字符串始终为 ASCII 字符串。 缓冲区必须包含终止 null 字符的空间。

[in] dwCapabilitiesStringLengthInCharacters

pszASCIICapabilitiesString 的大小（以字符为单位），包括终止 null 字符。

返回值

如果函数成功，则返回值为 TRUE。 如果函数失败，则返回值为 FALSE。 要获得更多的错误信息，请调用 GetLastError。

注解

此函数对应于显示数据通道命令接口 (DDC/CI) 标准的“功能请求 & 功能回复”命令。 有关功能字符串的详细信息，请参阅 DDC/CI 标准。

此函数通常快速返回，但有时可能需要几秒钟才能完成。

可以通过将 AddReg 指令添加到监视器的 INF 文件来更新监视器的功能字符串。 将名为“CapabilitiesString”的注册表项添加到监视器的驱动程序密钥。 注册表项的值是功能字符串。 注册表数据类型为REG_SZ。

HKR,,"CapabilitiesString",0x00000000,"updated capabilities string"
警告 除非熟悉 INF 文件的布局并了解 DDC/CI 标准，否则请勿修改监视器的 INF 文件。
 

示例


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
标头 lowlevelmonitorconfigurationapi.h
Library Dxva2.lib
DLL Dxva2.dll

另请参阅

监视配置函数