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 奈秒為單位。
規格需求
需求 | 值 |
---|---|
標頭 | strmini.h (包含 Strmini.h) |