Функция WdfUsbTargetDeviceRetrieveCurrentFrameNumber (wdfusb.h)

Статья
02/07/2025

[Применимо только к 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-ввода-вывода.

Примеры

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

ULONG  frameNumber;
PMY_DEVICE_CONTEXT  pMyDeviceContext;

pMyDeviceContext = GetDeviceContext(Device);

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

Требования

Требование	Ценность
целевая платформа	Всеобщий
минимальная версия KMDF	1.0
заголовка	wdfusb.h (include Wdfusb.h)
библиотеки	Wdf01000.sys (см. управление версиями библиотеки Платформы).)
IRQL	<=DISPATCH_LEVEL
правил соответствия DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

См. также

WdfUsbTargetDeviceCreateWithParameters

Поделиться через