HW_TIME_CONTEXT Struktur (strmini.h)

Der Klassentreiber übergibt eine HW_TIME_CONTEXT Struktur als Parameter, der von der StrMiniClock Routine eines Datenstroms ausgefüllt werden soll, oder gibt eine abgeschlossene HW_TIME_CONTEXT Struktur zurück, wenn sie auf eine StreamClassQueryMasterClock oder StreamClassQueryMasterClockSync Anforderung antwortet.

Syntax

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;

Angehörige

HwDeviceExtension

Verweist auf den Geräteerweiterungspuffer des Minidrivers. Der Klassentreiber füllt dieses Element aus, wenn er die Struktur an die StrMiniClock-eines Datenstroms oder an den an StreamClassQueryMasterClockübergebenen Rückruf übergibt. Wenn der Aufrufer als Parameter an StreamClassQueryMasterClockSyncübergeben wird, muss der Aufrufer dieses Member selbst ausfüllen.

Der Minidriver kann seine Geräteerweiterung verwenden, um private Informationen global auf dem Minidriver aufzuzeichnen. Der Minidriver legt die Größe dieses Puffers in der HW_INITIALIZATION_DATA Struktur fest, die er übergibt, wenn er sich über StreamClassRegisterMinidriver-registriert. Der Klassentreiber übergibt auch Zeiger an diesen Puffer im HwDeviceExtension Member des HW_STREAM_OBJECT, HW_STREAM_REQUEST_BLOCKund PORT_CONFIGURATION_INFORMATION Strukturen, die an den Minidriver übergeben werden.

HwStreamObject

Wenn der Klassentreiber HW_TIME_CONTEXT an die StrMiniClock-Routine eines Datenstroms übergibt, verweist dieses Element auf die HW_STREAM_OBJECT Struktur des Datenstroms.

Wenn der Klassentreiber eine abgeschlossene HW_TIME_CONTEXT Struktur an den von StreamClassQueryMasterClockbereitgestellten Rückruf übergibt, füllt er dieses Element mit einem Zeiger auf das Datenstromobjekt des Datenstroms aus, der die Abfrageanforderung vorgibt.

Function

Gibt den Typ des Zeitwerts an, der im element Time gespeichert ist. Mögliche Werte sind:

TIME_GET_STREAM_TIME

Das Time Member enthält den aktuellen Zeitstempel der Präsentation.

TIME_READ_ONBOARD_CLOCK

Das Time Member enthält die aktuelle Uhrzeit.

Time

Der Zeitwert in 100 Nanosekundeneinheiten, der durch das element Function angegeben wird.

SystemTime

Die aktuelle Systemzeit in 100 Nanosekundeneinheiten.

Anforderungen

Siehe auch

HW_CLOCK_OBJECT

StrMiniClock-

StreamClassQueryMasterClock-

StreamClassQueryMasterClockSync-