SRB_INDICATE_MASTER_CLOCK

类驱动程序发出此请求，以向流指示时钟对象的句柄（现在用作其主时钟）或零句柄以指示流是自由运行的。

返回值

微型驱动程序应将以下其中一项设置为 SRB 中的状态：

STATUS_SUCCESS
指示命令成功完成。

STATUS_NOT_IMPLEMENTED
指示微型驱动程序不支持函数。

STATUS_IO_DEVICE_ERROR
指示发生了硬件故障。

注释

类驱动程序设置 CommandData。MasterClockHandle 成员由 pSrb 指向表示主时钟的时钟对象的句柄。 pSrb 指针指向HW_STREAM_REQUEST_BLOCK结构。

流可以通过将主时钟句柄传递给 StreamClassQueryMasterClock 或 StreamClassQueryMasterClockSync 来查询主时钟的时间值。

在微型驱动程序收到特定流的SRB_INDICATE_MASTER_CLOCK之前，它可以假定该流是自由运行的。 如果从属引脚在此 SRB 中传递的句柄与 在 SRB_OPEN_MASTER_CLOCK 中传递给微型驱动程序的句柄相同，则微型驱动程序可以直接从主时钟读取时间，因为它控制主时钟和从属时钟。

微型驱动程序应在 SRB 中保留指向主时钟句柄的 CommandData.MasterClockHandle 字段。 如果此句柄为零，则向微型驱动程序指示此流现已自由运行，并且不能从属于主时钟。