StreamClassQueryMasterClockSync

The minidriver may call the StreamClassQueryMasterClockSync routine to synchronously query a stream's master clock.

VOID STREAMAPI
  StreamClassQueryMasterClockSync(
    IN HANDLE  MasterClockHandle,
    IN OUT PHW_TIME_CONTEXT  TimeContext
    );

Parameters

MasterClockHandle

Specifies the handle for the master clock that is being queried. The class driver passes this in the SRB_INDICATE_MASTER_CLOCK request to the minidriver's StrMiniReceiveStreamControlPacket routine.

TimeContext

Specifies the HW_TIME_CONTEXT structure that the class driver passes to the master clock's StrMiniClock routine. Before calling this routine, the minidriver must fill in the HwDeviceExtension, HwStreamObject, and Function members of TimeContext. StreamClassQueryMasterClockSync completes the Time and SystemTime members.

Return Value

None

Headers

Declared in strmini.h. Include strmini.h.

Comments

The routine must be called at or below DISPATCH_LEVEL. If the caller is running at a raised IRQL, it should use the asynchronous version, StreamClassQueryMasterClock, instead.

The class driver calls the master clock's StrMiniClock routine to query the clock.

On rare occasions, the graph manager switches the master clock. The class driver exposes a race condition in handling the new master clock. If the minidriver calls a stream class master clock routine immediately after it receives a new clock from the class driver, the class driver may produce unexpected results.

See Also

HW_TIME_CONTEXT, StreamClassQueryMasterClock, StrMiniReceiveStreamControlPacket, StrMiniClock