функция WinUsb_GetCurrentFrameNumberAndQpc (winusb.h)

Статья
08/27/2023

Функция WinUsb_GetCurrentFrameNumberAndQpc извлекает значение счетчика производительности системных запросов (QPC), синхронизированное с кадром и микрофреймом.

Синтаксис

BOOL WinUsb_GetCurrentFrameNumberAndQpc(
  [in] WINUSB_INTERFACE_HANDLE                             InterfaceHandle,
  [in] PUSB_FRAME_NUMBER_AND_QPC_FOR_TIME_SYNC_INFORMATION FrameQpcInfo
);

Параметры

[in] InterfaceHandle

Непрозрачный дескриптор, полученный при предыдущем вызове WinUsb_Initialize.

[in] FrameQpcInfo

Указатель на структуру USB_FRAME_NUMBER_AND_QPC_FOR_TIME_SYNC_INFORMATION . На выходных данных CurrentQueryPerformanceCounter присваивает системное значение QPC (в микросекундах), прогнозируемое стеком usb-драйверов. При необходимости при входе вызывающий объект может указать номер кадра и микрофрейма, для которого требуется получить значение QPC.

В выходных данных элементу QueryPerformanceCounterAtInputFrameOrMicroFrame присваивается значение QPC для этого кадра или микрофрейма.

Возвращаемое значение

WinUsb_GetCurrentFrameNumberAndQpc возвращает значение TRUE , если операция выполнена успешно. В противном случае эта подпрограмма возвращает значение FALSE, и вызывающий объект может получить зарегистрированную ошибку, вызвав Метод GetLastError.

GetLastError может возвращать один из следующих кодов ошибок.

Код возврата	Описание
ERROR_INVALID_HANDLE	Вызывающий объект передал значение NULL в параметре InterfaceHandle или FrameQpcInfo .

Требования

Требование	Значение
Минимальная версия клиента	Windows 10
Минимальная версия сервера	Windows Server 2016
Целевая платформа	Универсальное
Верхняя часть	winusb.h (включая Winusb.h)
Библиотека	Winusb.lib
DLL	Winusb.dll

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

WinUSB

Функции WinUSB

WinUsb_Initialize

WinUsb_StartTrackingForTimeSync

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