GetStatus

This function sends a GET_STATUS request to a USB device.

Syntax

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 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:

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/endpoint number.

lpwStatus

[OUT] Filled in with status word.

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.

This function is defined in the Mousedrv.cpp file.

See Also

AbortTransfer, GetStatus, GetTransferStatus, IsTransferComplete