Orologi predefiniti

I minidriver di streaming del kernel possono chiamare KsAllocateDefaultClockEx per allocare e inizializzare una struttura di clock predefinita. In alternativa, possono chiamare KsAllocateDefaultClock, che funge da wrapper per KsAllocateDefaultClockEx con parametri predefiniti per i membri non-orologio. Chiamare KsCreateDefaultClock dopo aver usato KsAllocateDefaultClockEx per inizializzare l'orologio predefinito.

L'orologio predefinito supporta KSPROPSETID_Clock e può essere accessibile esattamente come qualsiasi altro orologio presentato da un pin di filtro. La struttura dei dati sottostante viene tuttavia creata dal pin del filtro ed è condivisa da tale pin e da tutte le istanze dell'orologio create. L'orologio si basa sul pin per aggiornare lo stato corrente e altri elementi nella struttura condivisa. L'orologio predefinito gestisce le richieste di notifica e le interrogazioni dell'orologio.

Quando a un pin sul filtro che fornisce questo segnale orario viene assegnato un orologio master, il pin possiede questo orologio. Il pin deve fare riferimento all'oggetto file di orologio, come se fosse stata assegnata un'altra implementazione dell'orologio. L'orologio predefinito non fa riferimento all'oggetto file del pin quando viene creata un'istanza. Mantiene invece un conteggio dei riferimenti interno in base all'allocazione iniziale della struttura di clock comune e a ogni oggetto file aperto sull'orologio. Anche se il proprietario dell'orologio libera la struttura dell'orologio, rimane sul posto fino a quando tutti gli oggetti file non vengono chiusi. Il pin può accedere direttamente all'oggetto clock predefinito, anziché passare attraverso l'interfaccia clock standard.

I minidriver possono supportare la proprietà KSPROPERTY_CLOCK_FUNCTIONTABLE per fornire ai client in modalità utente un meccanismo per controllare l'ora del clock di riferimento. Questa proprietà riempie una struttura con puntatori di funzioni che consentono questo, supportando in tal modo la corrispondenza precisa delle frequenze.

Inoltre, i minidriver supportano la proprietà KSPROPERTY_STREAM_RATE se un pin specificato consente modifiche alla frequenza.

Le applicazioni che usano l'interfaccia proxy di streaming del kernel chiamano i metodi nell'interfaccia IKsClockPropertySet per ottenere e impostare l'ora sugli orologi fisici che possono essere usati altrove per l'adeguamento della velocità.

Per informazioni correlate, vedere Quality Management .