vendor_request.c

一个在Windows环境下允许用户程序访问USB设备的接口库的源代码.

/* LIBUSB-WIN32, Generic Windows USB Driver
 * Copyright (C) 2002-2003 Stephan Meyer, <[e-mail]>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */


#include "libusb_filter.h"


NTSTATUS vendor_request(libusb_device_extension *device_extension, 
			int request, int value, int index, 
			MDL *buffer, int size, int direction,
			int *sent, int timeout)
{
  NTSTATUS status = STATUS_SUCCESS;
  URB urb;

  debug_printf(DEBUG_MSG, "vendor_request(): request 0x%02x", request);
  debug_printf(DEBUG_MSG, "vendor_request(): value 0x%04x", value);
  debug_printf(DEBUG_MSG, "vendor_request(): index 0x%04x", index);
  debug_printf(DEBUG_MSG, "vendor_request(): size %d", size);

  if(direction == USBD_TRANSFER_DIRECTION_IN)
    {
      debug_printf(DEBUG_MSG, "vendor_request(): direction in");
    }
  else
    {
      debug_printf(DEBUG_MSG, "vendor_request(): direction out");
    }

  debug_printf(DEBUG_MSG, "vendor_request(): timeout %d", timeout);

  urb.UrbHeader.Function = URB_FUNCTION_VENDOR_DEVICE;
  urb.UrbHeader.Length = 
    sizeof(struct _URB_CONTROL_VENDOR_OR_CLASS_REQUEST);
  urb.UrbControlVendorClassRequest.Reserved = 0;
  urb.UrbControlVendorClassRequest.TransferFlags 
    = direction | USBD_SHORT_TRANSFER_OK ;
  urb.UrbControlVendorClassRequest.TransferBufferLength = size;
  urb.UrbControlVendorClassRequest.TransferBufferMDL = buffer;
  urb.UrbControlVendorClassRequest.TransferBuffer = NULL;
  urb.UrbControlVendorClassRequest.RequestTypeReservedBits = 0;
  urb.UrbControlVendorClassRequest.Request = (UCHAR)request;
  urb.UrbControlVendorClassRequest.Value = (USHORT)value;
  urb.UrbControlVendorClassRequest.Index = (USHORT)index;
  urb.UrbControlVendorClassRequest.Reserved1 = 0;
  urb.UrbControlVendorClassRequest.UrbLink = NULL;
  
  status = call_usbd(device_extension, (void *)&urb, 
		       IOCTL_INTERNAL_USB_SUBMIT_URB, timeout);
  
  if(!NT_SUCCESS(status) || !USBD_SUCCESS(urb.UrbHeader.Status))
    {
      debug_printf(DEBUG_ERR, "vendor_request(): request failed");
    }
  else
    {
      *sent = urb.UrbControlVendorClassRequest.TransferBufferLength;
    }
  return status;
}