[Applies to KMDF only]
The WdfUsbTargetDeviceCreateIsochUrb method allocates an isochronous USB request block (URB).
NTSTATUS WdfUsbTargetDeviceCreateIsochUrb( WDFUSBDEVICE UsbDevice, PWDF_OBJECT_ATTRIBUTES Attributes, ULONG NumberOfIsochPackets, WDFMEMORY *UrbMemory, PURB *Urb );
A handle to a USB device object that was obtained from a previous call to WdfUsbTargetDeviceCreateWithParameters.
A pointer to a caller-supplied WDF_OBJECT_ATTRIBUTES structure that contains attributes for the new memory object. If the driver provides this parameter, the structure's ParentObject member must be a USB device object (WDFUSBDEVICE) or a request object (WDFREQUEST) created by the framework, or any object whose chain of parents leads to one of these types. This parameter is optional and can be WDF_NO_OBJECT_ATTRIBUTES.
Specifies the number of isochronous packets for which the system allocates memory in the URB.
A pointer to a WDFMEMORY-typed location that receives a handle to a framework memory object.
A pointer to an URB structure that receives the address of the new isochronous URB. The framework initializes contents of the URB structure to zero. This parameter is optional and can be NULL.
WdfUsbTargetDeviceCreateIsochUrb returns STATUS_SUCCESS if the operation succeeds. Otherwise, this method can return one of the following values:
||An invalid parameter was detected.|
||The driver did not specify a client contract version when it called WDF_USB_DEVICE_CREATE_CONFIG_INIT.|
||Insufficient memory was available.|
This method also might return other NTSTATUS values.
Before calling WdfUsbTargetDeviceCreateIsochUrb, a driver must call WdfUsbTargetDeviceCreateWithParameters. If successful, WdfUsbTargetDeviceCreateIsochUrb returns a handle to a framework memory object that describes the newly allocated isochronous URB.
A driver can call WdfUsbTargetDeviceCreateIsochUrb to allocate a URB structure before calling WdfUsbTargetDeviceFormatRequestForUrb.
Typically, a driver calls WdfUsbTargetDeviceCreateIsochUrb from within a request handler.
The memory object and its buffer are deleted when the parent object is deleted. A driver can also delete a memory object and its buffer by calling WdfObjectDelete.
For related information, see the Remarks section of WdfUsbTargetDeviceCreateUrb.
The following code example is based on the PerformIsochTransfer routine in the Isorwr sample driver. The example calls WdfUsbTargetDeviceCreateIsochUrb to allocate an isochronous USB request block. The example determines the number of bytes required to hold the isochronous transfer request, and then manually configures the URB header and the isochronous packets in the URB. At this point, the driver can call WdfUsbTargetPipeFormatRequestForUrb, as shown in the example in WdfUsbTargetDeviceCreateUrb.
USBD_PIPE_HANDLE usbdPipeHandle; ULONG numPackets = UserBufferLength/TransferSizePerFrame; ULONG urbSize; PURB urb; WDFMEMORY memory;
|Minimum supported client||Windows Vista|
|Minimum KMDF version||1.11|
|Header||wdfusb.h (include Wdfusb.h)|
|Library||Wdf01000.sys (see Framework Library Versioning.)|
|DDI compliance rules||DriverCreate|