CapabilitiesRequestAndCapabilitiesReply 函式 (lowlevelmonitorconfigurationapi.h)

警告

實體監視器組態函式使用 VESA 監視器控制命令集 (MCCS) I²C 介面的標準。 許多監視器未完全實作該標準;因此，使用這些命令可能會導致未定義的監視行為。 不建議將這些函式用於任意監視器，而不需實際驗證它們如預期般運作。

擷取描述監視器功能的字串。

語法

_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
程式庫	Dxva2.lib
Dll	Dxva2.dll

另請參閱

監視組態函式