DXGKDDI_OPM_GET_RANDOM_NUMBER função de retorno de chamada (dispmprt.h)

Artigo
02/23/2024

A função DxgkDdiOPMGetRandomNumber recupera o número aleatório criptograficamente seguro do objeto de saída protegido de 128 bits.

Sintaxe

DXGKDDI_OPM_GET_RANDOM_NUMBER DxgkddiOpmGetRandomNumber;

NTSTATUS DxgkddiOpmGetRandomNumber(
  [in]  PVOID MiniportDeviceContext,
  [in]  HANDLE ProtectedOutputHandle,
  [out] PDXGKMDT_OPM_RANDOM_NUMBER RandomNumber
)
{...}

Parâmetros

[in] MiniportDeviceContext

Um identificador para um bloco de contexto associado a um adaptador de exibição. Anteriormente, a função DxgkDdiAddDevice do driver de miniport de exibição forneceu esse identificador para o subsistema de kernel de elementos gráficos DirectX.

[in] ProtectedOutputHandle

O identificador para um objeto de saída protegido. A função DxgkDdiOPMCreateProtectedOutput cria o objeto de saída protegido e retorna o identificador para o objeto .

[out] RandomNumber

Um ponteiro para uma estrutura DXGKMDT_OPM_RANDOM_NUMBER que recebe o número aleatório criptograficamente seguro do objeto de saída protegido de 128 bits se DxgkDdiOPMGetRandomNumber retornar com êxito.

Se DxgkDdiOPMGetRandomNumber falhar, o valor para o qual RandomNumber aponta será inalterado.

Cada objeto de saída protegido deve ter um número aleatório criptograficamente seguro de 128 bits diferente associado a ele.

Retornar valor

DxgkDdiOPMGetRandomNumber retornará STATUS_SUCCESS se for bem-sucedido. Caso contrário, ele retornará um dos códigos de erro definidos em Ntstatus.h.

Comentários

DxgkDdiOPMGetRandomNumber é chamado apenas uma vez para cada saída protegida e nunca é chamado após a chamada para a função DxgkDdiOPMSetSigningKeyAndSequenceNumbers .

Para obter mais informações sobre números aleatórios criptograficamente seguros, consulte a seção 2.8 em Criptografia Aplicada, Segunda Edição.

DxgkDdiOPMGetRandomNumber deve ser tornado paginável.