Compartilhar via

BTH_HCI_IOCTL_GET_HARDWARE_STATUS (Compact 2013)

  • Artigo

3/26/2014

This I/O control message retrieves the current state of the hardware. Send this message with DeviceIoControl.

Syntax

BOOL DeviceIoControl(
    HANDLE hDevice,           // handle to device
    DWORD dwIoControlCode,    // use BTH_HCI_IOCTL_GET_HARDWARE_STATUS
    LPVOID lpInBuffer,        // pointer to input buffer
    DWORD nInBufferSize,      // input buffer size
    LPVOID lpOutBuffer,       // pointer to output buffer
    DWORD nOutBufferSize,     // output buffer size
    LPDWORD lpBytesReturned,  // number of bytes returned
    OVERLAPPED lpOverlapped   // pointer to OVERLAPPED structure
);

Parameters

  • hDevice
    The handle to the device.
  • dwIoControlCode
    [in] Control code for the operation. Use BTH_HCI_IOCTL_GET_HARDWARE_STATUS for this operation.
  • lpInBuffer
    [in] Not used; set to NULL.
  • nInBufferSize
    [in] Not used; set to zero.

  • lpOutBuffer
    [out] Points to a DWORD that receives one of the values in the following table.

    Value

    Description

    HCI_HARDWARE_UNKNOWN

    The stack is not present.

    HCI_HARDWARE_RUNNING

    The adapter is installed and the stack is running.

    HCI_HARDWARE_INITIALIZING

    The adapter might be installed.

    The stack is on the way up. Call again later.

    HCI_HARDWARE_ERROR

    The adapter might be installed.

    The stack is on the way down. Call again later.

    HCI_HARDWARE_SHUTDOWN

    The adapter is installed, but the stack is not running.

    HCI_HARDWARE_NOT_PRESENT

    The adapter is not present.
  • nOutBufferSize
    [in] Set to sizeof(int).
  • lpBytesReturned
    [out] Same as nOutBufferSize.
  • lpOverlapped
    Ignored.

Requirements

Header

bt_ddi.h

See Also

Reference

Bluetooth HCI IOCTLs