WdfUsbTargetDeviceRetrieveCurrentFrameNumber 函数 (wdfusb.h)
[仅适用于 KMDF]
WdfUsbTargetDeviceRetrieveCurrentFrameNumber 方法检索当前的 USB 帧编号。
语法
NTSTATUS WdfUsbTargetDeviceRetrieveCurrentFrameNumber(
[in] WDFUSBDEVICE UsbDevice,
[out] PULONG CurrentFrameNumber
);
参数
[in] UsbDevice
USB 设备对象的句柄,该对象是从上一次调用 WdfUsbTargetDeviceCreateWithParameters 获取的。
[out] CurrentFrameNumber
指向接收当前 32 位 USB 帧号的位置的指针。
返回值
如果操作成功,WdfUsbTargetDeviceRetrieveCurrentFrameNumber 将返回STATUS_SUCCESS。 否则,此方法可以返回以下值之一:
返回代码 | 说明 |
---|---|
|
检测到参数无效。 |
|
帧编号不可用,可能是因为较低的驱动程序不提供帧编号。 |
此方法还可能返回其他 NTSTATUS 值。
如果驱动程序提供无效的对象句柄,则会发生 bug 检查。
注解
有关 WdfUsbTargetDeviceRetrieveCurrentFrameNumber 方法和 USB I/O 目标的详细信息,请参阅 USB I/O 目标。
示例
下面的代码示例调用 WdfUsbTargetDeviceRetrieveCurrentFrameNumber。 该示例从驱动程序定义的上下文空间获取 USB 设备对象句柄。
ULONG frameNumber;
PMY_DEVICE_CONTEXT pMyDeviceContext;
pMyDeviceContext = GetDeviceContext(Device);
status = WdfUsbTargetDeviceRetrieveCurrentFrameNumber(
pMyDeviceContext->UsbTargetDevice,
&frameNumber
);
要求
要求 | 值 |
---|---|
目标平台 | 通用 |
最低 KMDF 版本 | 1.0 |
标头 | wdfusb.h (包括 Wdfusb.h) |
Library | Wdf01000.sys (请参阅框架库 Versioning.) |
IRQL | <=DISPATCH_LEVEL |
DDI 符合性规则 | DriverCreate (kmdf) , KmdfIrql (kmdf) , KmdfIrql2 (kmdf) , KmdfIrqlExplicit (kmdf) , UsbKmdfIrql (kmdf) 、 UsbKmdfIrql2 (kmdf) 、UsbKmdfIrqlExplicit (kmdf) |