IOPMVideoOutput::StartInitialization 메서드(opmapi.h)

아티클
08/25/2023

OPM(출력 보호 관리자) 세션에 대한 초기화 시퀀스를 시작합니다.

구문

HRESULT StartInitialization(
  [out] OPM_RANDOM_NUMBER *prnRandomNumber,
  [out] BYTE              **ppbCertificate,
  [out] ULONG             *pulCertificateLength
);

매개 변수

[out] prnRandomNumber

OPM_RANDOM_NUMBER 구조체에 대한 포인터입니다. 구조체는 디스플레이 드라이버에서 생성된 128비트 난수를 받습니다. 이 숫자는 IOPMVideoOutput::FinishInitialization 메서드에 필요합니다.

[out] ppbCertificate

디스플레이 드라이버의 인증서를 포함하는 버퍼에 대한 포인터를 받습니다. 메서드는 버퍼에 대한 메모리를 할당합니다. 호출자는 CoTaskMemFree를 호출하여 메모리를 해제해야 합니다.

[out] pulCertificateLength

ppbCertificate가 가리키는 버퍼의 길이를 받습니다.

반환 값

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 메서드는 COPP(Certified Output Protection Protocol)의 IAMCertifiedOutputProtection::KeyExchange 메서드와 동일합니다.

메서드는 드라이버의 2048비트 RSA 공개 키를 포함하는 인증서 체인을 반환합니다. 호출자는 인증서 체인의 유효성을 검사한 다음 IOPMVideoOutput::FinishInitialization 을 호출하여 OPM 세션을 설정해야 합니다.

이 메서드는 OPM 의미 체계와 COPP 의미 체계를 모두 지원합니다. COPP 의미 체계는 이전 버전과의 호환성을 위해 지원됩니다. 새 애플리케이션은 OPM 의미 체계를 사용해야 합니다.

OPM 의미 체계

메서드는 X.509 인증서 체인을 반환합니다. 인증서 체인은 ASN.1 Distinguished Encoding Rules(DER)로 인코딩됩니다.

COPP 의미 체계

메서드는 COPP 인증서 체인을 반환합니다. 인증서 체인은 UTF-8 문자열로 반환됩니다. ppbCertificate에서 반환된 버퍼를 chars의 배열로 처리할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	opmapi.h

추가 정보

IOPMVideoOutput

출력 보호 관리자