WdfUsbTargetPipeGetInformation 函式 (wdfusb.h)
[適用於 KMDF 和 UMDF]
WdfUsbTargetPipeGetInformation 方法會擷取 USB 管道及其端點的相關信息。
語法
void WdfUsbTargetPipeGetInformation(
[in] WDFUSBPIPE Pipe,
[out] PWDF_USB_PIPE_INFORMATION PipeInformation
);
參數
[in] Pipe
呼叫 WdfUsbInterfaceGetConfiguredPipe 取得之架構管道物件的句柄。
[out] PipeInformation
呼叫端配置的 WDF_USB_PIPE_INFORMATION 結構的指標，可接收管道和端點的相關信息。
傳回值
無
備註
如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。
如需 WdfUsbTargetPipeGetInformation 方法和 USB I/O 目標的詳細資訊，請參閱 USB I/O 目標。
範例
下列程式代碼範例會初始化 WDF_USB_PIPE_INFORMATION 結構，並呼叫 WdfUsbTargetPipeGetInformation。
WDF_USB_PIPE_INFORMATION pipeInfo;
WDF_USB_PIPE_INFORMATION_INIT(&pipeInfo);
WdfUsbTargetPipeGetInformation(
Pipe,
&pipeInfo
);
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 最低 KMDF 版本 | 1.0 |
| 最低UMDF版本 | 2.0 |
| 標頭 | wdfusb.h (包含 Wdfusb.h) |
| 程式庫 | Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| DDI 合規性規則 | DriverCreate (kmdf) ， KmdfIrql (kmdf) ， KmdfIrql2 (kmdf) ， KmdfIrqlExplicit (kmdf) ， UsbKmdfIrql (kmdf) 、 UsbKmdfIrql2 (kmdf) 、UsbKmdfIrqlExplicit (kmdf) |