Função KsCreateDefaultClock (ks.h)

Dada uma solicitação IRP_MJ_CREATE, a função KsCreateDefaultClock cria um relógio padrão que usa o relógio do sistema como uma base de tempo e associa o IoGetCurrentIrpStackLocation(Irp)->FileObject ao relógio usando uma tabela de expedição interna (KSDISPATCH_TABLE). Não conclui o IRP nem define o status no IRP.

A função KsCreateDefaultClock só pode ser chamada em PASSIVE_LEVEL.

Sintaxe

KSDDKAPI NTSTATUS KsCreateDefaultClock(
  [in] PIRP            Irp,
  [in] PKSDEFAULTCLOCK DefaultClock
);

Parâmetros

[in] Irp

Especifica o IRP com a solicitação de criação de relógio sendo tratada.

[in] DefaultClock

Especifica uma estrutura de relógio padrão de inicialização que é compartilhada entre qualquer instância do relógio padrão para o pai.

Retornar valor

A função KsCreateDefaultClock retornará STATUS_SUCCESS se tiver êxito ou um erro, se não for bem-sucedido.

Comentários

O relógio pode ser criado depois de usar KsAllocateDefaultClock para criar e inicializar as estruturas internas para uma instância de relógio padrão. Após a inicialização, muitos objetos de arquivo podem ser criados na mesma instância de relógio padrão subjacente.

Requisitos

Confira também

KsAllocateDefaultClock