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 时，调用方必须填写此成员本身。

微型驱动程序可以使用其设备扩展将全局私人信息记录到微型驱动程序。 微型驱动程序在通过 StreamClassRegisterMinidriver 自行注册时，在它传递的HW_INITIALIZATION_DATA结构中设置此缓冲区的大小。 类驱动程序还会将指针传递到HW_STREAM_OBJECT的 HwDeviceExtension 成员中的此缓冲区，HW_STREAM_REQUEST_BLOCK，并将PORT_CONFIGURATION_INFORMATION结构传递给微型驱动程序。

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

由 Function 成员指定的时间值（以 100 纳秒为单位）。

SystemTime

当前系统时间，以 100 纳秒为单位。

要求

要求 值
Header strmini.h (包括 Strmini.h)

另请参阅

HW_CLOCK_OBJECT

StrMiniClock

StreamClassQueryMasterClock

StreamClassQueryMasterClockSync