structure HW_TIME_CONTEXT (strmini.h)
Le pilote de classe transmet une structure HW_TIME_CONTEXT en tant que paramètre à remplir par la routine StrMiniClock d’un flux, ou retourne une structure HW_TIME_CONTEXT terminée lorsqu’elle répond à une requête StreamClassQueryMasterClock ou StreamClassQueryMasterClockSync.
Syntaxe
typedef struct _HW_TIME_CONTEXT {
struct _HW_DEVICE_EXTENSION *HwDeviceExtension;
struct _HW_STREAM_OBJECT *HwStreamObject;
TIME_FUNCTION Function;
ULONGLONG Time;
ULONGLONG SystemTime;
} HW_TIME_CONTEXT, *PHW_TIME_CONTEXT;
Membres
HwDeviceExtension
Pointe vers la mémoire tampon d’extension d’appareil du minidriver. Le pilote de classe remplit ce membre lorsqu’il transmet la structure à l'StrMiniClock d’un flux ou au rappel passé à StreamClassQueryMasterClock. Lorsqu’il est passé en tant que paramètre à StreamClassQueryMasterClockSync, l’appelant doit renseigner ce membre lui-même.
Le minidriver peut utiliser son extension d’appareil pour enregistrer des informations privées globales sur le minidriver. Le minidriver définit la taille de cette mémoire tampon dans la structure HW_INITIALIZATION_DATA qu’il transmet lorsqu’il s’inscrit via StreamClassRegisterMinidriver. Le pilote de classe transmet également des pointeurs vers cette mémoire tampon dans le HwDeviceExtension membre du HW_STREAM_OBJECT, HW_STREAM_REQUEST_BLOCKet PORT_CONFIGURATION_INFORMATION structures qu’il transmet au minidriver.
HwStreamObject
Lorsque le pilote de classe passe HW_TIME_CONTEXT à la routine StrMiniClock d’un flux, ce membre pointe vers la structure HW_STREAM_OBJECT du flux.
Lorsque le pilote de classe transmet une structure HW_TIME_CONTEXT terminée au rappel fourni par StreamClassQueryMasterClock, il remplit ce membre avec un pointeur vers l’objet de flux du flux qui effectue la requête de requête.
Function
Spécifie le type de valeur de temps stockée dans le membre Time. Les valeurs possibles sont les suivantes :
TIME_GET_STREAM_TIME
Le membre Time contient l’horodatage de présentation actuel.
TIME_READ_ONBOARD_CLOCK
Le membre Time contient l’heure de l’horloge actuelle.
Time
Valeur de temps, en unités de 100 nanosecondes, spécifiée par le membre fonction.
SystemTime
Heure système actuelle, en unités de 100 nanosecondes.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | strmini.h (include Strmini.h) |