共用方式為

WdfUsbTargetDeviceCreateIsochUrb 函式 (wdfusb.h)

  • 發行項

[僅適用於 KMDF]

WdfUsbTargetDeviceCreateIsochUrb 方法會配置異時 USB 要求區塊 (URB) 。

語法

NTSTATUS WdfUsbTargetDeviceCreateIsochUrb(
  [in]            WDFUSBDEVICE           UsbDevice,
  [in, optional]  PWDF_OBJECT_ATTRIBUTES Attributes,
  [in]            ULONG                  NumberOfIsochPackets,
  [out]           WDFMEMORY              *UrbMemory,
  [out, optional] PURB                   *Urb
);

參數

[in] UsbDevice

從先前呼叫 WdfUsbTargetDeviceCreateWithParameters 取得的 USB 裝置物件的句柄。

[in, optional] Attributes

呼叫端提供的 WDF_OBJECT_ATTRIBUTES 結構的指標，其中包含新記憶體對象的屬性。 如果驅動程式提供此參數，結構的 ParentObject 成員必須是 USB 裝置物件 (WDFUSBDEVICE) 或由架構建立的 WDFREQUEST) (WDFREQUEST) ，或是父系鏈結導致這些類型的其中一個物件。 此參數是選擇性的，而且可以WDF_NO_OBJECT_ATTRIBUTES。

[in] NumberOfIsochPackets

指定系統在 URB 中設定記憶體的時序封包數目。

[out] UrbMemory

接收架構記憶體物件句柄的 WDFMEMORY 型別位置指標。

[out, optional] Urb

URB 結構的指標，可接收新無時序 URB 的位址。 架構會將 URB 結構的內容初始化為零。 此參數是選擇性的，可以是 NULL。

傳回值

WdfUsbTargetDeviceCreateIsochUrb 會在作業成功時傳回STATUS_SUCCESS。 否則，此方法可以傳回下列其中一個值：

傳回碼 Description
STATUS_INVALID_PARAMETER
 偵測到無效的參數。
STATUS_INVALID_DEVICE_STATE
 驅動程式在呼叫 WDF_USB_DEVICE_CREATE_CONFIG_INIT時未指定客戶端合約版本。
STATUS_INSUFFICIENT_RESOURCES
 記憶體不足。
 

這個方法也可能傳回其他 NTSTATUS值。

備註

在呼叫 WdfUsbTargetDeviceCreateIsochUrb 之前，驅動程式必須呼叫 WdfUsbTargetDeviceCreateWithParameters。 如果成功， WdfUsbTargetDeviceCreateIsochUrb 會傳回架構記憶體物件的句柄，描述新配置的異動 URB。

驅動程式可以呼叫 WdfUsbTargetDeviceCreateIsochUrb 來配置 URB 結構，再呼叫 WdfUsbTargetDeviceFormatRequestForUrb。

一般而言，驅動程式會從要求處理程式內呼叫 WdfUsbTargetDeviceCreateIsochUrb。

刪除父物件時，會刪除記憶體物件及其緩衝區。 驅動程式也可以藉由呼叫 WdfObjectDelete 來刪除記憶體物件及其緩衝區。

如需相關信息，請參閱 WdfUsbTargetDeviceCreateUrb 的一節。

範例

下列程式代碼範例是以Isorwr範例驅動程式中的PerformIsochTransfer例程為基礎。 此範例會呼叫 WdfUsbTargetDeviceCreateIsochUrb 來配置不連續的 USB 要求區塊。 此範例會決定保存連續傳輸要求所需的位元組數目，然後手動設定 URB 標頭和 URB 中的連續封包。 此時，驅動程式可以呼叫 WdfUsbTargetPipeFormatRequestForUrb，如 WdfUsbTargetDeviceCreateUrb 中的範例所示。


USBD_PIPE_HANDLE usbdPipeHandle;
ULONG numPackets = UserBufferLength/TransferSizePerFrame;
ULONG urbSize;
PURB urb;  
WDFMEMORY memory;

WDF_OBJECT_ATTRIBUTES_INIT(&objectAttribs);  
objectAttribs.ParentObject = UsbDevice;

status = WdfUsbTargetDeviceCreateIsochUrb(
                                     pDevContext->WdfUsbTargetDevice,  
                                     &objectAttribs,  
                                     0, 
                                     numPackets, 
                                     &memory,  
                                     NULL  
                                     ); 
 
urb = WdfMemoryGetBuffer(urbMemory, &urbSize); 
urbSize = GET_ISO_URB_SIZE(numPackets);  

usbdPipeHandle = WdfUsbTargetPipeWdmGetPipeHandle(pipe);
urb->UrbIsochronousTransfer.Hdr.Length = GET_ISO_URB_SIZE(numPackets);  
urb->UrbIsochronousTransfer.Hdr.Function = URB_FUNCTION_ISOCH_TRANSFER;  
urb->UrbIsochronousTransfer.PipeHandle = usbdPipeHandle; 

for (packetId = 0; packetId < numberOfPackets; packetId++) {

     Urb-> UrbIsochronousTransfer.IsoPacket[packetId].Offset = xxx;
     Urb-> UrbIsochronousTransfer.IsoPacket[packetId].YYY = yyy;
}

規格需求

需求 值
最低支援的用戶端 Windows Vista
目標平台 Universal
最小 KMDF 版本 1.11
標頭 wdfusb.h (包含 Wdfusb.h)
程式庫 Wdf01000.sys (請參閱 Framework Library Versioning.)
IRQL <=DISPATCH_LEVEL
DDI 合規性規則 DriverCreate (kmdf)

另請參閱

WdfUsbTargetDeviceCreateUrb

WdfUsbTargetDeviceCreateWithParameters