Condividi tramite


Funzione StreamClassQueryMasterClockSync (strmini.h)

Il minidriver può chiamare la routine StreamClassQueryMasterClockSync per eseguire query sincrone sull'orologio master di un flusso.

Sintassi

VOID STREAMAPI StreamClassQueryMasterClockSync(
  [in]      HANDLE           MasterClockHandle,
  [in, out] PHW_TIME_CONTEXT TimeContext
);

Parametri

[in] MasterClockHandle

Specifica l'handle per l'orologio master su cui viene eseguita una query. Il driver di classe passa questo valore nella richiesta di SRB_INDICATE_MASTER_CLOCK alla routine StrMiniReceiveStreamControlPacket del minidriver.

[in, out] TimeContext

Specifica la struttura HW_TIME_CONTEXT che il driver di classe passa alla routine StrMiniClock del clock master. Prima di chiamare questa routine, il minidriver deve compilare i membri HwDeviceExtension, HwStreamObjecte Function di TimeContext. StreamClassQueryMasterClockSync completa i membri Time e SystemTime.

Valore restituito

Nessuno

Osservazioni

La routine deve essere chiamata al DISPATCH_LEVEL o al di sotto di . Se il chiamante è in esecuzione in un runtime di integrazione generato, deve usare invece la versione asincrona, StreamClassQueryMasterClock.

Il driver di classe chiama l'orologio master StrMiniClock routine per eseguire query sull'orologio.

In rari casi, il gestore del grafico cambia l'orologio master. Il pilota di classe espone una race condition nella gestione del nuovo orologio master. Se il minidriver chiama una routine dell'orologio master della classe di flusso immediatamente dopo che riceve un nuovo orologio dal driver di classe, il driver di classe potrebbe produrre risultati imprevisti.

Fabbisogno

Requisito Valore
piattaforma di destinazione Desktop
intestazione strmini.h (include Strmini.h)
libreria Stream.lib
IRQL <=DISPATCH_LEVEL (vedere la sezione Osservazioni)

Vedere anche

HW_TIME_CONTEXT

StrMiniClock

StrMiniReceiveStreamControlPacket

StreamClassQueryMasterClock