DXGKDDI_OPM_GET_RANDOM_NUMBER función de devolución de llamada (dispmprt.h)
La función DxgkDdiOPMGetRandomNumber recupera el número aleatorio de 128 bits del objeto de salida protegido especificado.
Sintaxis
DXGKDDI_OPM_GET_RANDOM_NUMBER DxgkddiOpmGetRandomNumber;
NTSTATUS DxgkddiOpmGetRandomNumber(
[in] PVOID MiniportDeviceContext,
[in] HANDLE ProtectedOutputHandle,
[out] PDXGKMDT_OPM_RANDOM_NUMBER RandomNumber
)
{...}
Parámetros
[in] MiniportDeviceContext
Identificador de un bloque de contexto asociado a un adaptador de pantalla. Anteriormente, la función DxgkDdiAddDevice del controlador de miniporte de pantalla proporcionó este identificador al subsistema del kernel de gráficos de DirectX.
[in] ProtectedOutputHandle
Identificador de un objeto de salida protegido. La función DxgkDdiOPMCreateProtectedOutput crea el objeto de salida protegido y devuelve el identificador al objeto .
[out] RandomNumber
Puntero a una estructura de DXGKMDT_OPM_RANDOM_NUMBER que recibe el número aleatorio criptográfico de 128 bits del objeto de salida protegido si DxgkDdiOPMGetRandomNumber devuelve correctamente.
Si se produce un error en DxgkDdiOPMGetRandomNumber , el valor al que RandomNumber apunta a no cambia.
Cada objeto de salida protegido debe tener un número aleatorio criptográfico de 128 bits diferente asociado a él.
Valor devuelto
DxgkDdiOPMGetRandomNumber devuelve STATUS_SUCCESS si se ejecuta correctamente. De lo contrario, devuelve uno de los códigos de error definidos en Ntstatus.h.
Comentarios
Se llama a DxgkDdiOPMGetRandomNumber solo una vez para cada salida protegida y nunca se llama después de llamar a la función DxgkDdiOPMSetSigningKeyAndSequenceNumbers.
Para obtener más información sobre los números aleatorios seguros criptográficamente, vea la sección 2.8 en Criptografía aplicada, Segunda edición.
DxgkDdiOPMGetRandomNumber debe ser paginable.
Requisitos
Requisito | Value |
---|---|
Plataforma de destino | Escritorio |
Encabezado | dispmprt.h (include Dispmprt.h) |
IRQL | PASSIVE_LEVEL (consulte la sección Comentarios) |