Expand Minimize

UsbBuildGetStatusRequest routine

The UsbBuildGetStatusRequest macro formats an URB to obtain status from a device, interface, endpoint, or other device-defined target on a USB device.

Syntax


void UsbBuildGetStatusRequest(
  _Inout_    Urb,
  _In_      USHORT Op,
  _In_      USHORT Index,
  _In_opt_  PVOID TransferBuffer,
  _In_opt_  PMDL TransferBufferMDL,
  _In_      PURB Link
);

Parameters

Urb [in, out]

Pointer to an URB to be formatted as an status request.

Op [in]

Specifies one of the following values:

URB_FUNCTION_GET_STATUS_FROM_DEVICE

Retrieves status from a USB device.

URB_FUNCTION_GET_STATUS_FROM_INTERFACE

Retrieves status from an interface on a USB device.

URB_FUNCTION_GET_STATUS_FROM_ENDPOINT

Retrieves status from an endpoint for an interface on a USB device.

URB_FUNCTION_GET_STATUS_FROM_OTHER

Retrieves status from a device-defined target on a USB device.

Index [in]

Specifies the device-defined index, returned by a successful configuration request, if the request is for an endpoint or interface. Otherwise, Index must be zero.

TransferBuffer [in, optional]

Pointer to a resident buffer to receive the status data or is NULL if an MDL is supplied in TransferBufferMDL.

TransferBufferMDL [in, optional]

Pointer to an MDL that describes a resident buffer to receive the status data or is NULL if a buffer is supplied in TransferBuffer.

Link [in]

Reserved. Must be set to NULL.

Return value

This routine does not return a value.

Requirements

Header

Usbdlib.h (include Usbdlib.h)

See also

URB
_URB_CONTROL_GET_STATUS_REQUEST
Routines for USB Client Drivers

 

 

Send comments about this topic to Microsoft

Build date: 12/5/2013

Show:
© 2014 Microsoft. All rights reserved.