IssueVendorTransfer

  • Article

This function sends a vendor-specific control transfer to a USB device.

USB_TRANSFER IssueVendorTransfer(
  USB_HANDLE hDevice,
  LPTRANSFER_NOTIFY_ROUTINE lpStartAddress,
  LPVOID lpvNotifyParameter,
  DWORD dwFlags,
  LPCUSB_DEVICE_REQUEST lpControlHeader,
  LPVOID lpvBuffer,
  ULONG uBufferPhysicalAddress 
);

Parameters

  • hDevice
    [in] Handle to a USB device.
  • lpStartAddress
    [in] Pointer to the address, which may be NULL, of a callback routine.
  • lpvNotifyParameter
    [in] Pointer to the parameter to pass to a callback routine.
  • dwFlags
    [in] Flags for the transfer. These flags shown in the following list are declared in the Usbtypes.h header file.
    • USB_IN_TRANSFER
    • USB_OUT_TRANSFER
    • USB_NO_WAIT
    • USB_SHORT_TRANSFER_OK
    • USB_START_ISOCH_ASAP
    • USB_COMPRESS_ISOCH
    • USB_SEND_TO_DEVICE
    • USB_SEND_TO_INTERFACE
    • USB_SEND_TO_ENDPOINT
    • USB_DONT_BLOCK_FOR_MEM
  • lpControlHeader
    [in] Pointer to a device request header.
  • lpvBuffer
    [in] Data buffer. If a physical buffer address is specified, this must contain the virtual address of the buffer.
  • uBufferPhysicalAddress
    [in] Physical address, which may be NULL, of the data buffer.

Return Values

A USB_TRANSFER handle indicates success. NULL indicates failure.

Remarks

This function initiates a control transfer to a USB device on the default endpoint, zero (0). This function is intended for vendor-specific transfers. For standard transfers, use a corresponding function, such as GetInterface or SetInterface.

Requirements

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

See Also

AbortTransfer | GetInterface | GetTransferStatus | IsTransferComplete | SetInterface | USB Drivers

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.