Share via


OALIoCtlHalGetHWEntropy (Windows Embedded CE 6.0)

1/5/2010

This function implements the IOCTL_HAL_GET_HWENTROPY handler. OALIoCtlHalGetHWEntropy creates a 64-bit value that is unique to the hardware and does not change.

Syntax

BOOL OALIoCtlHalGetHWEntropy(
  UINT32 dwIOControlCode,
  VOID* lpInBuf,
  UINT32 nInBufSize,
  VOID* lpOutBuf,
  UINT32 nOutBufSize,
  UINT32* lpBytesReturned
);

Parameters

  • dwIoControlCode
    [in] Set to IOCTL_HAL_GET_HWENTROPY.
  • lpInBuf
    [in] Set to NULL.
  • nInBufsize
    [in] Set to zero.
  • lpOutBuf
    [in, out] On input, set to the address of an allocated buffer to contain the 64-bit random seed.

    On output, the buffer is filled with the 64-bit random number.

  • nOutBufSize
    [in] Set to the size of the buffer allocated to store the random number.
  • lpBytesReturned
    [in, out] On input, address of a DWORD that receives the size, in bytes, of the data returned.

    On output, set to the number of bytes written to the supplied buffer.

Return Value

TRUE indicates success.

FALSE indicates failure.

Requirements

Header oal_ioctl.h
Library Developer Implemented
Windows Embedded CE Windows CE 5.0 and later

See Also

Reference

IOCTL Functions