GetStatus

  • Article

This function sends a GET_STATUS request to a USB device.

USB_TRANSFER GetStatus(
  USB_HANDLE hDevice,
  LPTRANSFER_NOTIFY_ROUTINE lpStartAddress,
  LPVOID lpvNotifyParameter,
  DWORD dwFlags,
  UCHAR bIndex,
  LPWORD lpwStatus 
);

Parameters

  • hDevice
    [in] Handle to a USB device.
  • lpStartAddress
    [in] Pointer to a callback routine, which may be NULL.
  • lpvNotifyParameter
    [in] Pointer to the parameter to pass to a callback routine.
  • dwFlags
    [in] Value of USB_NO_WAIT or zero (0), and one of the values from the following table.
    Value Description
    USB_SEND_TO_DEVICE Request for status of the device.
    USB_SEND_TO_INTERFACE Request for status of the interface.
    USB_SEND_TO_ENDPOINT Request for status of the endpoint.
  • bIndex
    [in] Value of zero (0) for DEVICE, or interface or endpoint number.
  • lpwStatus
    [out] Device's status.

Return Values

A USB_TRANSFER handle indicates success. NULL indicates failure.

Remarks

This function initiates a control transfer to a USB device requesting device, interface, or endpoint status.

Requirements

OS Versions: Windows CE 2.10 and later.
Header: Usbd.hpp.

See Also

AbortTransfer | GetStatus | GetTransferStatus | IsTransferComplete | USB Drivers

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.