DXGKDDI_OPM_GET_CERTIFICATE 콜백 함수(dispmprt.h)

아티클
04/03/2024

DxgkDdiOPMGetCertificate 함수는 지정된 형식 및 크기의 인증서를 검색합니다.

구문

DXGKDDI_OPM_GET_CERTIFICATE DxgkddiOpmGetCertificate;

NTSTATUS DxgkddiOpmGetCertificate(
  [in]  PVOID MiniportDeviceContext,
  [in]  DXGKMDT_CERTIFICATE_TYPE CertificateType,
  [in]  ULONG CertificateSize,
  [out] PVOID CertificateBuffer
)
{...}

매개 변수

[in] MiniportDeviceContext

디스플레이 어댑터와 연결된 컨텍스트 블록에 대한 핸들입니다. 이전에는 디스플레이 미니포트 드라이버의 DxgkDdiAddDevice 함수가 DirectX 그래픽 커널 하위 시스템에 이 핸들을 제공했습니다.

[in] CertificateType

검색할 인증서 유형을 식별하는 DXGKMDT_CERTIFICATE_TYPE 형식의 값입니다.

[in] CertificateSize

검색할 인증서의 크기(바이트)입니다. 이 크기는 디스플레이 미니포트 드라이버의 DxgkDdiOPMGetCertificateSize 함수를 호출하여 반환되었습니다.

[out] CertificateBuffer

DxgkDdiOPMGetCertificate가 성공적으로 반환되는 경우 요청된 인증서를 수신하는 버퍼에 대한 포인터입니다. DxgkDdiOPMGetCertificate가 실패하면 버퍼의 내용은 변경되지 않습니다.

반환 값

DxgkDdiOPMGetCertificate 는 다음 값 중 하나를 반환합니다.

반환 코드	설명
STATUS_SUCCESS	함수가 인증서 크기를 성공적으로 검색했습니다.
STATUS_GRAPHICS_OPM_NOT_SUPPORTED	디스플레이 미니포트 드라이버는 하드웨어 공급업체가 OPM 사용권 계약에 서명한 적이 없거나 미니포트 드라이버의 그래픽 하드웨어가 OPM 규칙을 준수하지 않기 때문에 OPM을 지원하지 않습니다. DxgkDdiOPMGetCertificate는 디스플레이 미니포트 드라이버가 변조를 감지한 경우에도 이 값을 반환할 수 있습니다.
STATUS_GRAPHICS_COPP_NOT_SUPPORTED	디스플레이 미니포트 드라이버는 하드웨어 공급업체가 COPP 사용권 계약에 서명하지 않았거나 미니포트 드라이버의 그래픽 하드웨어가 COPP 규칙을 준수하지 않기 때문에 COPP를 지원하지 않습니다. DxgkDdiOPMGetCertificate는 디스플레이 미니포트 드라이버가 변조를 감지한 경우에도 이 값을 반환할 수 있습니다.
STATUS_GRAPHICS_UAB_NOT_SUPPORTED	디스플레이 미니포트 드라이버는 하드웨어 공급업체가 UAB 사용권 계약에 서명한 적이 없거나 미니포트 드라이버의 그래픽 하드웨어가 UAB 규칙을 준수하지 않기 때문에 UAB를 지원하지 않습니다. DxgkDdiOPMGetCertificate는 디스플레이 미니포트 드라이버가 변조를 감지한 경우에도 이 값을 반환할 수 있습니다.
STATUS_GRAPHICS_PVP_HFS_FAILED	디스플레이 미니포트 드라이버의 HFS(하드웨어 기능 검사)가 실패했거나 디스플레이 미니포트 드라이버가 변조를 감지했습니다. 디스플레이 미니포트 드라이버는 필요에 따라 이 값을 반환할 수 있습니다. DxgkDdiOPMGetCertificate가 변조에 대해 이 값을 반환하지 않으면 이전 오류 코드 중 하나를 대신 반환할 수 있습니다.

이 함수는 Ntstatus.h에 정의된 다른 오류 코드를 반환할 수도 있습니다.

설명

DxgkDdiOPMGetCertificate 는 디스플레이 미니포트 드라이버의 OPM 인증서, UAB(사용자 액세스 가능 버스) 인증서 또는 COPP(Certified Output Protection Protocol) 인증서를 검색할 수 있습니다. 이러한 인증서에 대한 자세한 내용은 출력 콘텐츠 보호 및 Windows Vista 문서를 다운로드하세요.

DxgkDdiOPMGetCertificate 를 페이징 가능으로 만들어야 합니다.