StreamClassQueryMasterClockSync, fonction (strmini.h)

Article
02/07/2025

Le minidriver peut appeler la routine StreamClassQueryMasterClockSync pour interroger de façon synchrone l’horloge principale d’un flux.

Syntaxe

VOID STREAMAPI StreamClassQueryMasterClockSync(
  [in]      HANDLE           MasterClockHandle,
  [in, out] PHW_TIME_CONTEXT TimeContext
);

Paramètres

[in] MasterClockHandle

Spécifie le handle de l’horloge principale interrogée. Le pilote de classe le transmet dans la requête SRB_INDICATE_MASTER_CLOCK à la routine StrMiniReceiveStreamControlPacket du minidriver.

[in, out] TimeContext

Spécifie la structure HW_TIME_CONTEXT que le pilote de classe passe à la routine StrMiniClock de l’horloge principale. Avant d’appeler cette routine, le minidriver doit renseigner les HwDeviceExtension, HwStreamObjectet Function membres de TimeContext. StreamClassQueryMasterClockSync termine les membres Time et SystemTime.

Valeur de retour

Aucun

Remarques

La routine doit être appelée à l’DISPATCH_LEVEL ou en dessous. Si l’appelant s’exécute à un irQL déclenché, il doit utiliser la version asynchrone, StreamClassQueryMasterClock, à la place.

Le pilote de classe appelle le StrMiniClock de l’horloge principale routine pour interroger l’horloge.

À de rares occasions, le gestionnaire de graphiques change l’horloge principale. Le pilote de classe expose une condition de course dans la gestion du nouvel horloge maître. Si le minidriver appelle une routine d’horloge maître de classe de flux immédiatement après qu’il reçoit une nouvelle horloge du pilote de classe, le pilote de classe peut produire des résultats inattendus.