DXGKDDI_OPM_GET_RANDOM_NUMBER función de devolución de llamada (dispmprt.h)

Artículo
02/26/2024

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.