HW_TIME_CONTEXT structure (strmini.h)
Le pilote de classe transmet une structure de 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 au 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 lui-même via StreamClassRegisterMinidriver. Le pilote de classe transmet également des pointeurs vers cette mémoire tampon dans le membre HwDeviceExtension des structures HW_STREAM_OBJECT, HW_STREAM_REQUEST_BLOCK et PORT_CONFIGURATION_INFORMATION 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 de HW_TIME_CONTEXT terminée au rappel fourni par StreamClassQueryMasterClock, il remplit ce membre avec un pointeur vers l’objet stream du flux qui effectue la requête.
Function
Spécifie le type de valeur de temps qui est stocké dans le membre Time . Les valeurs possibles sont les suivantes :
TIME_GET_STREAM_TIME
Le membre Time détient l’horodatage de présentation actuel.
TIME_READ_ONBOARD_CLOCK
Le membre Time détient l’heure d’horloge actuelle.
Time
Valeur de temps, en unités de 100 nanosecondes, spécifiée par le membre Function .
SystemTime
Heure système actuelle, en unités de 100 nanosecondes.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | strmini.h (include Strmini.h) |