função WinUsb_GetCurrentFrameNumberAndQpc (winusb.h)

Artigo
03/13/2024

A função WinUsb_GetCurrentFrameNumberAndQpc recupera o valor do QPC (contador de desempenho de consulta do sistema) sincronizado com o quadro e o microframe.

Sintaxe

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

Parâmetros

[in] InterfaceHandle

Um identificador opaco recuperado na chamada anterior para WinUsb_Initialize.

[in] FrameQpcInfo

Um ponteiro para uma estrutura USB_FRAME_NUMBER_AND_QPC_FOR_TIME_SYNC_INFORMATION . Na saída, CurrentQueryPerformanceCounter definido como o valor QPC do sistema (em microssegundos) previsto pela pilha de driver USB. Opcionalmente, na entrada, o chamador pode especificar um quadro e um número de microframe para o qual recuperar o valor de QPC.

Na saída, o membro QueryPerformanceCounterAtInputFrameOrMicroFrame é definido como o valor QPC desse quadro ou microframe.

Retornar valor

WinUsb_GetCurrentFrameNumberAndQpcretornará TRUE se a operação for bem-sucedida. Caso contrário, essa rotina retornará FALSE e o chamador poderá recuperar o erro registrado chamando GetLastError.

GetLastError pode retornar um dos seguintes códigos de erro.

Código de retorno	Descrição
ERROR_INVALID_HANDLE	O chamador passou NULL no parâmetro InterfaceHandle ou FrameQpcInfo .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10
Servidor mínimo com suporte	Windows Server 2016
Plataforma de Destino	Universal
Cabeçalho	winusb.h (inclua Winusb.h)
Biblioteca	Winusb.lib
DLL	Winusb.dll

Confira também

WinUSB

Funções do WinUSB

WinUsb_Initialize

WinUsb_StartTrackingForTimeSync

Compartilhar via