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.
Valor de retorno
A função KsAllocateDefaultClock retorna STATUS_SUCCESS se bem-sucedida ou um erro de memória se não tiver êxito.
Observações
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á-la 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 |
|---|---|
| da Plataforma de Destino | Universal |
| cabeçalho | ks.h (incluir Ks.h) |
| biblioteca | Ks.lib |
| IRQL | PASSIVE_LEVEL |