функция обратного вызова 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
Указатель на структуру DXGKMDT_OPM_RANDOM_NUMBER, которая получает 128-разрядное криптографическое случайное число защищенного объекта, если DxgkDdiOPMGetRandomNumber успешно возвращается.
Если DxgkDdiOPMGetRandomNumber завершается ошибкой, значение, которое RandomNumber указывает на то, что значение не изменяется.
Каждый защищенный выходной объект должен иметь другое 128-разрядное криптографическое безопасное случайное число, связанное с ним.
Возвращаемое значение
DxgkDdiOPMGetRandomNumber возвращает STATUS_SUCCESS, если он выполнен успешно. В противном случае возвращается один из кодов ошибок, определенных в Ntstatus.h.
Замечания
DxgkDdiOPMGetRandomNumber вызывается только один раз для каждого защищенного вывода и никогда не вызывается после вызова функции DxgkDdiOPMSetSigningKeyAndSequenceNumbers.
Дополнительные сведения о криптографически безопасных случайных числах см. в разделе 2.8 в примененной криптографии, Second Edition.
DxgkDdiOPMGetRandomNumber должен быть доступен для страницы.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | dispmprt.h (include Dispmprt.h) |
| IRQL | PASSIVE_LEVEL (см. раздел "Примечания") |