Microsoft Windows CE 3.0  

GetStatus

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

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] Specify USB_NO_WAIT or 0, plus one of the following:
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] Specifies 0 for DEVICE, or interface or endpoint number.
lpwStatus
[OUT] Filled in with the 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

Runs on Versions Defined in Include Link to
Windows CE OS 2.10 and later      
Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

AbortTransfer, GetStatus, GetTransferStatus, IsTransferComplete



 Last updated on Tuesday, July 13, 2004

© 2004 Microsoft Corporation. All rights reserved.