HW_TIME_CONTEXT 結構 (strmini.h)

類別驅動程式會將HW_TIME_CONTEXT結構當做數據流的 StrMiniClock 例程填入的參數，或在回應 StreamClassQueryMasterClock 或 StreamClassQueryMasterClockSync 要求時傳回已完成的HW_TIME_CONTEXT結構。

語法

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;

成員

HwDeviceExtension

指向迷你驅動程式的裝置擴充緩衝區。 當類別驅動程式將 結構傳遞至數據流的 StrMiniClock，或傳遞至 StreamClassQueryMasterClock 的回呼時，類別驅動程式就會填入這個成員。 噹噹做參數傳遞至 StreamClassQueryMasterClockSync 時，呼叫端必須填入這個成員本身。

minidriver 可以使用其裝置擴充功能，將私人資訊全域記錄到minidriver。 minidriver 會在它透過 StreamClassRegisterMinidriver 註冊本身時，在HW_INITIALIZATION_DATA結構中設定這個緩衝區的大小。 類別驅動程式也會在HW_STREAM_OBJECT、HW_STREAM_REQUEST_BLOCK的HwDeviceExtension 成員中傳遞這個緩衝區的指標，並PORT_CONFIGURATION_INFORMATION傳遞至 minidriver 的結構。

HwStreamObject

當類別驅動程式將HW_TIME_CONTEXT傳遞至數據流的 StrMiniClock 例程時，這個成員會指向 數據流HW_STREAM_OBJECT結構 。

當類別驅動程式將已完成的HW_TIME_CONTEXT結構傳遞至 StreamClassQueryMasterClock 所提供的回呼時，它會以發出查詢要求之數據流物件的指標填入這個成員。

Function

指定儲存在 Time 成員中的時間值類型。 可能的值包括：

TIME_GET_STREAM_TIME

Time 成員會保存目前的簡報時間戳。

TIME_READ_ONBOARD_CLOCK

Time 成員會保存目前的時鐘時間。

Time

時間值，以 100 奈秒為單位，由 Function 成員指定。

SystemTime

目前的系統時間，以 100 奈秒為單位。

規格需求

另請參閱

HW_CLOCK_OBJECT

StrMiniClock

StreamClassQueryMasterClock

StreamClassQueryMasterClockSync