DXGKDDI_OPM_GET_RANDOM_NUMBER 콜백 함수(dispmprt.h)
DxgkDdiOPMGetRandomNumber 함수는 지정된 보호된 출력 개체의 128비트 암호화 보안 난수를 검색합니다.
구문
DXGKDDI_OPM_GET_RANDOM_NUMBER DxgkddiOpmGetRandomNumber;
NTSTATUS DxgkddiOpmGetRandomNumber(
[in] PVOID MiniportDeviceContext,
[in] HANDLE ProtectedOutputHandle,
[out] PDXGKMDT_OPM_RANDOM_NUMBER RandomNumber
)
{...}
매개 변수
[in] MiniportDeviceContext
디스플레이 어댑터와 연결된 컨텍스트 블록에 대한 핸들입니다. 이전에는 디스플레이 미니포트 드라이버의 DxgkDdiAddDevice 함수가 DirectX 그래픽 커널 하위 시스템에 이 핸들을 제공했습니다.
[in] ProtectedOutputHandle
보호된 출력 개체에 대한 핸들입니다. DxgkDdiOPMCreateProtectedOutput 함수는 보호된 출력 개체를 만들고 개체에 대한 핸들을 반환합니다.
[out] RandomNumber
DxgkDdiOPMGetRandomNumber가 성공적으로 반환되는 경우 보호된 출력 개체의 128비트 암호화 보안 난수를 수신하는 DXGKMDT_OPM_RANDOM_NUMBER 구조체에 대한 포인터입니다.
DxgkDdiOPMGetRandomNumber가 실패하면 RandomNumber가 가리키는 값은 변경되지 않습니다.
보호된 각 출력 개체에는 연결된 다른 128비트 암호화 보안 난수가 있어야 합니다.
반환 값
DxgkDdiOPMGetRandomNumber 는 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 Ntstatus.h에 정의된 오류 코드 중 하나를 반환합니다.
설명
DxgkDdiOPMGetRandomNumber 는 보호된 각 출력에 대해 한 번만 호출되며 DxgkDdiOPMSetSigningKeyAndSequenceNumbers 함수를 호출한 후에는 호출되지 않습니다.
암호화로 안전한 난수에 대한 자세한 내용은 적용된 암호화, 두 번째 버전의 섹션 2.8을 참조하세요.
DxgkDdiOPMGetRandomNumber 를 페이징 가능으로 만들어야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 데스크톱 |
| 머리글 | dispmprt.h(Dispmprt.h 포함) |
| IRQL | PASSIVE_LEVEL(설명 섹션 참조) |