Função KsAllocateDefaultClock (ks.h)

A função KsAllocateDefaultClock aloca e inicializa a estrutura de relógio padrão.

Sintaxe

KSDDKAPI NTSTATUS KsAllocateDefaultClock(
  [out] PKSDEFAULTCLOCK *DefaultClock
);

Parâmetros

[out] DefaultClock

Especifica a estrutura de relógio padrão compartilhada alocada pelo chamador. A hora atual é definida como zero e o estado é definido como KSSTATE_STOP. Após a conclusão bem-sucedida dessa rotina, a estrutura indicada por esse ponteiro conterá uma referência ao relógio padrão. Os dados retornados devem ser tratados como opacos e reservados para uso do sistema.

Retornar valor

A função KsAllocateDefaultClock retornará STATUS_SUCCESS se tiver êxito ou um erro de memória se não tiver êxito.

Comentários

O elemento DefaultClock.ReferenceCount interno é inicializado para um pela função KsAllocateDefaultClock . O elemento é incrementado e decrementado à medida que cada DPC de notificação é enfileirada e concluída. Quando a estrutura deve ser liberada, o elemento é usado para determinar se o proprietário do relógio deve liberar a estrutura ou se um DPC pendente deve liberá-lo de forma assíncrona.

Quando o relógio não for mais necessário, o driver deverá chamar KsFreeDefaultClock para liberar todos os recursos alocados para uso com o relógio.

Requisitos

Confira também

KsAllocateDefaultClockEx

KsFreeDefaultClock