WinUsb_GetCurrentFrameNumberAndQpc-Funktion (winusb.h)

Die WinUsb_GetCurrentFrameNumberAndQpc-Funktion ruft den QPC-Wert (System Query Performance Counter) ab, der mit dem Frame und dem Microframe synchronisiert wird.

Syntax

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

Parameter

[in] InterfaceHandle

Ein undurchsichtiges Handle, das beim vorherigen Aufruf von WinUsb_Initialize abgerufen wurde.

[in] FrameQpcInfo

Ein Zeiger auf eine USB_FRAME_NUMBER_AND_QPC_FOR_TIME_SYNC_INFORMATION-Struktur . Bei der Ausgabe wird CurrentQueryPerformanceCounter auf den QPC-Systemwert (in Mikrosekunden) festgelegt, der vom USB-Treiberstapel vorhergesagt wird. Optional kann der Aufrufer bei der Eingabe einen Frame und eine Microframenummer angeben, für die der QPC-Wert abgerufen werden soll.

Bei der Ausgabe wird das QueryPerformanceCounterAtInputFrameOrMicroFrame-Element auf den QPC-Wert für diesen Frame oder Microframe festgelegt.

Rückgabewert

WinUsb_GetCurrentFrameNumberAndQpc gibt TRUE zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Routine FALSE zurück, und der Aufrufer kann den protokollierten Fehler durch Aufrufen von GetLastError abrufen.

GetLastError kann einen der folgenden Fehlercodes zurückgeben.

Rückgabecode	Beschreibung
ERROR_INVALID_HANDLE	Der Aufrufer hat NULL im Parameter InterfaceHandle oder FrameQpcInfo übergeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10
Unterstützte Mindestversion (Server)	Windows Server 2016
Zielplattform	Universell
Header	winusb.h (winusb.h einschließen)
Bibliothek	Winusb.lib
DLL	Winusb.dll

Weitere Informationen

Winusb

WinUSB-Funktionen

WinUsb_Initialize

WinUsb_StartTrackingForTimeSync