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)
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