DXGKDDI_OPM_GET_RANDOM_NUMBER função de retorno de chamada (dispmprt.h)
A função DxgkDdiOPMGetRandomNumber recupera o número aleatório criptograficamente seguro de 128 bits do objeto de saída protegido fornecido.
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 miniporto 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 de DXGKMDT_OPM_RANDOM_NUMBER que recebe o número aleatório criptograficamente seguro de 128 bits do objeto de saída protegido se DxgkDdiOPMGetRandomNumber retornar com êxito.
Se DxgkDdiOPMGetRandomNumber falhar, o valor ao qual RandomNumber aponta permanece inalterado.
Cada objeto de saída protegido deve ter um número aleatório criptograficamente seguro de 128 bits diferente associado a ele.
Valor de retorno
DxgkDdiOPMGetRandomNumber retornará STATUS_SUCCESS se tiver êxito. Caso contrário, ele retornará um dos códigos de erro definidos em Ntstatus.h.
Observações
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 de Criptografia Aplicada, Segunda Edição.
DxgkDdiOPMGetRandomNumber deve ser tornada paginável.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | dispmprt.h (inclua Dispmprt.h) |
| IRQL | PASSIVE_LEVEL (consulte a seção Comentários) |