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
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Cabeçalho | ks.h (inclua Ks.h) |
| Biblioteca | Ks.lib |
| IRQL | PASSIVE_LEVEL |