Standardklockor

Kernel streaming-minidrivrutiner kan anropa KsAllocateDefaultClockEx för att allokera och initiera en standardklockstruktur. Alternativt kan de anropa KsAllocateDefaultClock, som är en omslutning för KsAllocateDefaultClockEx med standardparametrar för icke-klockmedlemmar. Anropa KsCreateDefaultClock när du har använt KsAllocateDefaultClockEx för att initiera standardklockan.

Standardklockan stöder KSPROPSETID_Clock och kan nås precis som andra klockor som presenteras av en filterpin. Den underliggande datastrukturen skapas dock av filterstiftet och delas av pin-koden och alla instanser av klockan som skapas. Klockan förlitar sig på pin-koden för att uppdatera det aktuella tillståndet och andra element i den delade strukturen. Standardklockan hanterar meddelandeförfrågningar och klockfrågor.

När ett stift på filtret som ger den här klockan tilldelas en huvudklocka, äger stiftet den här klockan. Pin-koden bör referera till klockfilobjektet, precis som om det tilldelades någon annan klockimplementering. Standardklockan refererar inte till pin-kodens filobjekt när en instans skapas. I stället behåller den ett internt referensantal baserat på den inledande allokeringen av den gemensamma klockstrukturen och på varje filobjekt som öppnas på klockan. Även om klockans ägare frigör klockstrukturen förblir den på plats tills alla filobjekt stängs. Pin-koden kan komma åt standardklockaobjektet direkt i stället för att gå igenom standardklockans gränssnitt.

Minidrivers kan stödja egenskapen KSPROPERTY_CLOCK_FUNCTIONTABLE för att ge klienter i användarläge en mekanism för att kontrollera referensklockans tid. Den här egenskapen fyller i en struktur med funktionspekare som aktiverar detta, vilket ger stöd för exakt hastighetsmatchning.

Dessutom stöder minidrivrutiner egenskapen KSPROPERTY_STREAM_RATE om en angiven pin tillåter hastighetsändringar.

Program som använder anropsmetoderna för proxygränssnittet för kernelströmning i gränssnittet IKsClockPropertySet för att hämta och ange tid på fysiska klockor som kan användas någon annanstans för hastighetsmatchning.

Se Kvalitetshantering för relaterad information.