SetDescriptor

This function sends a SET_DESCRIPTOR request to a USB device.

Syntax

USB_TRANSFER SetDescriptor( USB_HANDLE hDevice, LPTRANSFER_NOTIFY_ROUTINE lpStartAddress,
LPVOID lpvNotifyParameter, DWORD dwFlags, UCHAR bType,
UCHAR bIndex, WORD wLanguage, WORD wLength, LPVOID lpvBuffer );

Parameters

hDevice

[IN] Handle to a USB device.

lpStartAddress

[IN] Pointer to the address of a callback routine, which may be NULL.

lpvNotifyParameter

[IN] Pointer to the parameter to pass to a callback routine.

dwFlags

[IN] Specifies USB_NO_WAIT, or 0

bType

[IN] Specifies the descriptor type; one of the values USB_DEVICE_DESCRIPTOR_TYPE, USB_CONFIGURATION_DESCRIPTOR_TYPE, USB_STRING_DESCRIPTOR_TYPE, or a vendor specific value.

bIndex

[IN] Specifies an index within the descriptor.

wLanguage

[IN] Specifies the language identifier for string descriptors; 0 for others.

wLength

[IN] Specifies the descriptor length.

lpvBuffer

[IN] Specifies the buffer for descriptor data.

Return Values

A USB_TRANSFER handle indicates success. NULL indicates failure.

Remarks

This function initiates a control transfer to a USB device, which sets device descriptor information.

This function is defined in the Mousedrv.cpp file.

See Also

AbortTransfer, GetDescriptor, GetTransferStatus, IsTransferComplete