Relógios padrão

Os minidrivers de streaming do kernel podem chamar KsAllocateDefaultClockEx para alocar e inicializar uma estrutura de relógio padrão. Como alternativa, eles podem chamar KsAllocateDefaultClock, que é um envoltório para KsAllocateDefaultClockEx com parâmetros padrão para os membros não-relacionados ao relógio. Chame KsCreateDefaultClock depois de usar KsAllocateDefaultClockEx para inicializar o relógio padrão.

O relógio padrão dá suporte ao KSPROPSETID_Clock e pode ser acessado assim como qualquer outro relógio apresentado por um pino de filtro. A estrutura de dados subjacente, no entanto, é criada pelo pino de filtro e compartilhada por esse pino e quaisquer instâncias do relógio que forem criadas. O relógio depende do pino para atualizar o estado atual e outros elementos na estrutura compartilhada. O relógio padrão manipula solicitações de notificação e consultas de relógio.

Quando um pino no filtro que fornece esse relógio é atribuído a um relógio mestre, o pino possui esse relógio. O pino deve referenciar o objeto de arquivo de relógio, assim como se tivesse sido atribuída alguma outra implementação de relógio. O relógio padrão não faz referência ao objeto de arquivo do pino quando uma instância é criada. Em vez disso, ele mantém uma contagem de referência interna com base na alocação inicial da estrutura de relógio comum e em cada objeto de arquivo que é aberto no relógio. Mesmo que o proprietário do relógio libere a sua estrutura, ela permanecerá no lugar até que todos os objetos de arquivo sejam fechados. O pino pode acessar diretamente o objeto de relógio padrão, em vez de passar pela interface do relógio padrão.

Os minidrivers podem suportar a propriedade KSPROPERTY_CLOCK_FUNCTIONTABLE para fornecer aos clientes do modo de usuário um mecanismo para verificar a hora do relógio de referência. Essa propriedade preenche uma estrutura com ponteiros de função que permitem isso, proporcionando suporte ao ajuste preciso de taxa.

Além disso, os minidrivers dão suporte à propriedade KSPROPERTY_STREAM_RATE se um pin especificado permitir alterações de taxa.

Aplicativos que utilizam a interface de proxy de streaming do kernel chamam métodos na interface IKsClockPropertySet para obter e definir o tempo em relógios físicos que podem ser usados em outros lugares para sincronização de taxa.

Consulte o Gerenciamento de Qualidade para obter informações relacionadas.