CapabilitiesRequestAndCapabilitiesReply 함수(lowlevelmonitorconfigurationapi.h)

경고

물리적 모니터 구성 함수는 I²C 인터페이스를 통해 MCCS(VESA Monitor Control Command Set) 표준을 사용하여 작동합니다. 대부분의 모니터는 해당 표준을 완전히 구현하지 않습니다. 따라서 이러한 명령을 사용하면 정의되지 않은 모니터 동작이 발생할 수 있습니다. 의도한 대로 작동하는지 물리적으로 확인하지 않고 임의 모니터에 이러한 함수를 사용하지 않는 것이 좋습니다.

모니터의 기능을 설명하는 문자열을 검색합니다.

구문

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

매개 변수

[in] hMonitor

실제 모니터에 대한 핸들입니다. 모니터 핸들을 얻으려면 GetPhysicalMonitorsFromHMONITOR 또는 GetPhysicalMonitorsFromIDirect3DDevice9를 호출합니다.

[out] pszASCIICapabilitiesString

모니터의 기능 문자열을 수신하는 버퍼에 대한 포인터입니다. 호출자는 이 버퍼를 할당해야 합니다. 문자열의 크기를 얻으려면 GetCapabilitiesStringLength를 호출합니다. 기능 문자열은 항상 ASCII 문자열입니다. 버퍼는 종료 null 문자에 대한 공간을 포함해야 합니다.

[in] dwCapabilitiesStringLengthInCharacters

종료 null 문자를 포함하여 pszASCIICapabilitiesString 의 크기입니다.

반환 값

함수가 성공하면 반환 값은 TRUE입니다. 함수가 실패하면 반환 값은 FALSE입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

이 함수는 DDC/CI(표시 데이터 채널 명령 인터페이스) 표준의 "기능 요청 & 기능 회신" 명령에 해당합니다. 기능 문자열에 대한 자세한 내용은 DDC/CI 표준을 참조하세요.

이 함수는 일반적으로 빠르게 반환되지만 완료하는 데 몇 초 정도 걸릴 수 있습니다.

모니터의 INF 파일에 AddReg 지시문을 추가하여 모니터의 기능 문자열을 업데이트할 수 있습니다. 모니터의 드라이버 키에 "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

추가 정보

구성 함수 모니터링