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 er 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;

Member

HwDeviceExtension

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

Der Minidriver kann seine Geräteerweiterung verwenden, um private Informationen global für den 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_BLOCK und PORT_CONFIGURATION_INFORMATION Strukturen, die er an den Minitreiber übergibt.

HwStreamObject

Wenn der Klassentreiber HW_TIME_CONTEXT an die StrMiniClock-Routine eines Streams übergibt, verweist dieser Member auf die HW_STREAM_OBJECT Struktur des Streams.

Wenn der Klassentreiber eine abgeschlossene HW_TIME_CONTEXT-Struktur an den von StreamClassQueryMasterClock bereitgestellten Rückruf übergibt, füllt er diesen Member mit einem Zeiger auf das Streamobjekt des Datenstroms aus, der die Abfrageanforderung stellt.

Function

Gibt den Typ des Zeitwerts an, der im Time-Member gespeichert wird. Mögliche Werte:

TIME_GET_STREAM_TIME

Das Time-Element enthält den aktuellen Präsentationszeitstempel.

TIME_READ_ONBOARD_CLOCK

Das Time-Element enthält die aktuelle Uhrzeit.

Time

Der Zeitwert in Einheiten von 100 Nanosekunden, der vom Funktionselement angegeben wird.

SystemTime

Die aktuelle Systemzeit in 100 Nanosekundeneinheiten.

Anforderungen

Anforderung Wert
Header strmini.h (include Strmini.h)

Weitere Informationen

HW_CLOCK_OBJECT

StrMiniClock

StreamClassQueryMasterClock

StreamClassQueryMasterClockSync