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 함수에 대한 호출이 발생한 후에는 호출되지 않습니다.
암호화 방식으로 안전한 난수에 대한 자세한 내용은 Applied Cryptography, Second Edition의 섹션 2.8을 참조하세요.
DxgkDdiOPMGetRandomNumber 페이징 가능해야 합니다.
요구 사항
| 요구 | 값 |
|---|---|
| 대상 플랫폼 | 바탕 화면 |
| 헤더 | dispmprt.h(Dispmprt.h 포함) |
| IRQL | PASSIVE_LEVEL(설명 섹션 참조) |