streamClassQueryMasterClockSync 函数 (strmini.h)
微型驱动程序可以调用 StreamClassQueryMasterClockSync 例程,以同步查询流的主时钟。
语法
VOID STREAMAPI StreamClassQueryMasterClockSync(
[in] HANDLE MasterClockHandle,
[in, out] PHW_TIME_CONTEXT TimeContext
);
参数
[in] MasterClockHandle
指定要查询的主时钟的句柄。 类驱动程序在SRB_INDICATE_MASTER_CLOCK请求中将此传递给微型驱动程序的 StrMiniReceiveStreamControlPacket 例程。
[in, out] TimeContext
指定类驱动程序传递给主时钟的 StrMiniClock 例程的HW_TIME_CONTEXT结构。 在调用此例程之前,微型驱动程序必须填充 TimeContext 的 HwDeviceExtension、HwStreamObject 和 Function 成员。 StreamClassQueryMasterClockSync 完成 Time 和 SystemTime 成员。
返回值
无
备注
必须在DISPATCH_LEVEL或以下调用例程。 如果调用方在引发的 IRQL 上运行,则应改用异步版本 StreamClassQueryMasterClock。
类驱动程序调用主时钟的 StrMiniClock 例程来查询时钟。
在极少数情况下,图形管理器会切换主时钟。 类驱动程序在处理新的主时钟时公开争用条件。 如果微型驱动程序在收到来自类驱动程序的新时钟后立即调用流类主时钟例程,则类驱动程序可能会产生意外结果。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | strmini.h (包括 Strmini.h) |
Library | Stream.lib |
IRQL | <=DISPATCH_LEVEL (请参阅备注部分) |