DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT 콜백 함수(dispmprt.h)

아티클
08/07/2023

DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT 함수는 지정된 보호된 출력 개체를 구성합니다.

구문

DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT DxgkddiOpmConfigureProtectedOutput;

NTSTATUS DxgkddiOpmConfigureProtectedOutput(
  [in] PVOID MiniportDeviceContext,
  [in] HANDLE ProtectedOutputHandle,
  [in] const DXGKMDT_OPM_CONFIGURE_PARAMETERS *Parameters,
  [in] ULONG AdditionalParametersSize,
  [in] const VOID *AdditionalParameters
)
{...}

매개 변수

[in] MiniportDeviceContext

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

[in] ProtectedOutputHandle

보호된 출력 개체에 대한 핸들입니다. DxgkDdiOPMCreateProtectedOutput 함수는 보호된 출력 개체를 만들고 개체에 대한 핸들을 반환합니다.

[in] Parameters

ProtectedOutputHandle 매개 변수에 핸들이 지정된 보호된 출력 개체를 구성하는 데 사용되는 매개 변수를 포함하는 DXGKMDT_OPM_CONFIGURE_PARAMETERS 구조체에 대한 포인터입니다.

[in] AdditionalParametersSize

AdditionalParameters에서 가리키는 버퍼의 추가 매개 변수 크기(바이트)입니다. COPP(Certified Output Protection Protocol) 에뮬레이션의 경우 0입니다.

[in] AdditionalParameters

ProtectedOutputHandle 매개 변수에 핸들이 지정된 보호된 출력 개체를 구성하는 데 사용되는 추가 매개 변수를 포함하는 버퍼에 대한 포인터입니다. COPP 에뮬레이션의 경우 NULL입니다. AdditionalParametersSize 매개 변수가 0으로 설정된 경우 AdditionalParameters는 항상 NULL로 설정됩니다.

반환 값

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

반환 코드	설명
STATUS_SUCCESS	함수가 보호된 출력 개체를 구성했습니다.
STATUS_NO_MEMORY	DxgkDdiOPMConfigureProtectedOutput은 완료하는 데 필요한 메모리를 할당할 수 없습니다.

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

설명

DirectX 그래픽 커널 하위 시스템은 DxgkDdiOPMGetInformation 또는 DxgkDdiOPMGetCOPPCompatibleInformation 을 호출하여 출력에 대한 정보를 검색한 다음 DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT 한 번 이상 호출하여 출력을 구성합니다.

DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT 페이지를 만들 수 있어야 합니다.