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 结构的指针，该结构接收有关管道和终结点的信息。

返回值

无

备注

如果驱动程序提供无效的对象句柄，则会发生 bug 检查。

有关 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
                               );

要求

要求 值
目标平台 通用
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
标头 wdfusb.h (包括 Wdfusb.h)
Library Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
DDI 符合性规则 DriverCreate (kmdf) ， KmdfIrql (kmdf) ， KmdfIrql2 (kmdf) ， KmdfIrqlExplicit (kmdf) ， UsbKmdfIrql (kmdf) 、 UsbKmdfIrql2 (kmdf) 、UsbKmdfIrqlExplicit (kmdf)

另请参阅

WDF_USB_PIPE_INFORMATION

WDF_USB_PIPE_INFORMATION_INIT

WdfUsbInterfaceGetConfiguredPipe