IOCTL_HAL_GET_HWENTROPY
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Este IOCTL recupera uma 64-bit aleatório número com base em um identificador hardware dispositivo OEM-defined.
O KernelIoControl função chama esse IOCTL.
Parâmetros
- dwIoControlCode
[no] Defina como IOCTL_HAL_GET_HWENTROPY.
- lpInBuf
[no] Definir como NULL.
- nInBufsize
[no] Definido como zero.
lpOutBuf
[in, Out] Na entrada, defina como o endereço de uma reserva alocada para conter a 64-bit aleatório propagação.Na saída, a reserva é preenchida com a 64-bit aleatório número.
- nOutBufSize
[no] Definido para o tamanho da reserva alocada para armazenar o aleatório número.
lpBytesReturned
[in, Out] Na entrada, endereço de um DWORD que recebe o tamanho, em bytes, dos dados retornados.Na saída, defina como o número de bytes gravados para a reserva fornecida.
Valores Return
Se a função for bem-sucedido, o valor de retorno é TRUE. Se a função falhar, o valor de retorno é zero ou FALSE.
Se o valor de retorno é FALSE, GetLastError será definido para o erro encontrado ao processamento de solicitação. Se GetLastError é igual a ERROR_NOT_SUPPORTED, IOCTL_HAL_GET_HWENTROPY não é com suporte sobre o dispositivo. Se GetLastError é igual a ERROR_INSUFFICENT_BUFFER, a reserva passada para o KernelIoControl função não era grande o suficiente. Neste maiúsculas e minúsculas, se lpBytesReturned não é igual a NULL, o tamanho do exigido reserva é gravada a localidade apontada por esse parâmetro. Se GetLastError é igual a ERROR_INVALID_PARAMETER, os parâmetros para a função eram inválido.
Se não for fornecido suporte para IOCTL_HAL_GET_HWENTROPY dentro de OEMIoControl função ou se a solicitação falhar, o valor de retorno for FALSE.
Remarks
Os OEMs devem implementar a seção de codificar na OAL ao identificador de chamar para o KernelIoControl função. A 64 recuperados-aleatório bit número deve ser o mesmo em todas as chamadas no mesmo dispositivo. Ele deve ser diferente em cada dispositivo. E ele não deve ser possível descobrir o número fornecido os valores IOCTL_HAL_GET_HWENTROPY para outros dispositivos.
Requisitos
| Header | pkfuncs.h |
| Windows Embedded CE | Windows CE .NET 4.1 and later |