CapabilitiesRequestAndCapabilitiesReply 関数 (lowlevelmonitorconfigurationapi.h)

警告

物理モニター構成機能は、I²C インターフェース上で VESA モニター制御コマンド・セット (MCCS) 標準を使用して機能します。 多くのモニターでは、その標準が完全に実装されていません。そのため、これらのコマンドを使用すると、未定義のモニター動作が発生する可能性があります。 これらの関数は、意図したとおりに動作することを物理的に検証せずに、任意のモニターに使用することはお勧めしません。

モニターの機能を説明する文字列を取得します。

構文

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

パラメーター

[in] hMonitor

物理モニターへのハンドル。 モニター ハンドルを取得するには、 GetPhysicalMonitorsFromHMONITOR または GetPhysicalMonitorsFromIDirect3DDevice9 を呼び出します。

[out] pszASCIICapabilitiesString

モニターの機能文字列を受け取るバッファーへのポインター。 呼び出し元は、このバッファーを割り当てる必要があります。 文字列のサイズを取得するには、 GetCapabilitiesStringLength を呼び出します。 capabilities 文字列は常に ASCII 文字列です。 バッファーには、終端の null 文字の領域を含める必要があります。

[in] dwCapabilitiesStringLengthInCharacters

終端の null 文字を含む、文字内の pszASCIICapabilitiesString のサイズ。

戻り値

関数が成功した場合、戻り値は TRUE になります。 関数が失敗した場合、戻り値は FALSE になります。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

この関数は、Display Data Channel Command Interface (DDC/CI) 標準の "Capabilities Request & Capabilities Reply" コマンドに対応します。 機能文字列の詳細については、DDC/CI 標準を参照してください。

通常、この関数はすばやく戻りますが、完了するまでに数秒かかる場合があります。

モニターの INF ファイルに AddReg ディレクティブを追加することで、モニターの機能文字列を更新できます。 "CapabilitiesString" という名前のレジストリ キーをモニターのドライバー キーに追加します。 レジストリ キーの値は、capabilities 文字列です。 レジストリ データ型が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

こちらもご覧ください

構成関数の監視