Функция 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, если операция выполнена успешно. В противном случае этот метод может возвращать одно из следующих значений:

Код возврата Описание
STATUS_INVALID_PARAMETER
 Обнаружен недопустимый параметр.
STATUS_UNSUCCESSFUL
 Номер кадра был недоступен, возможно, потому, что более низкие драйверы не предоставляют номера кадров.
 

Этот метод также может возвращать другие значения NTSTATUS.

Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Комментарии

Дополнительные сведения о методе WdfUsbTargetDeviceRetrieveCurrentFrameNumber и целевых объектах USB-ввода-вывода см. в разделе Usb I/O Targets.

Примеры

В следующем примере кода вызывается WdfUsbTargetDeviceRetrieveCurrentFrameNumber. Этот пример получает дескриптор объекта USB-устройства из контекстного пространства, определяемого драйвером.

ULONG  frameNumber;
PMY_DEVICE_CONTEXT  pMyDeviceContext;

pMyDeviceContext = GetDeviceContext(Device);

status = WdfUsbTargetDeviceRetrieveCurrentFrameNumber(
                                              pMyDeviceContext->UsbTargetDevice,
                                              &frameNumber
                                              );

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1,0
Верхняя часть wdfusb.h (включая Wdfusb.h)
Библиотека Wdf01000.sys (см. раздел Управление версиями библиотеки Платформы).
IRQL <=DISPATCH_LEVEL
Правила соответствия DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

См. также раздел

WdfUsbTargetDeviceCreateWithParameters