Share via

OALIoCtlHalGetUUID (Compact 2013)

  • Article

10/16/2014

This function implements the IOCTL_HAL_GET_UUID handler. OALIoCtlHalGetUUID returns the universally unique identifier (UUID). The UUID is a 16-byte integer that is represented as a string and is guaranteed to be unique.

OALIoCtlHalGetUUID has been replaced by IOCTL_HAL_GET_DEVICE_INFO.

Syntax

BOOL OALIoCtlHalGetUUID (
  UINT32 dwIoControlCode,
  VOID* lpInBuf,
  UINT32 nInBufSize,
  VOID* lpOutBuf,
  UINT32 nOutBufSize,
  UINT32* lpBytesReturned
);

Parameters

  • dwIoControlCode
    [in] Set to IOCTL_HAL_GET_UUID to retrieve a UUID based upon an OEM-defined device hardware identifier.

    The OEM must implement the section of code in the OAL to handle the call to the KernelIoControl function.

  • lpInBuf
    [in] Set to NULL.
  • nInBufSize
    [in] Set to zero.

  • lpOutBuf
    [in, out] On input, set to the address of an allocated UUID structure.

    On output, a filled UUID structure.

  • nOutBufSize
    [in] Set to the size of the UUID structure.

  • 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

See Also

Reference

IOCTL Functions