Funzione KsAllocateDefaultClock (ks.h)

La funzione KsAllocateDefaultClock alloca e inizializza la struttura di clock predefinita.

Sintassi

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

Parametri

[out] DefaultClock

Specifica la struttura di clock predefinita condivisa allocata dal chiamante. L'ora corrente è impostata su zero e lo stato è impostato su KSSTATE_STOP. Al termine di questa routine, la struttura indicata da questo puntatore conterrà un riferimento all'orologio predefinito. I dati restituiti devono essere considerati opachi e riservati per l'uso del sistema.

Valore restituito

La funzione KsAllocateDefaultClock restituisce STATUS_SUCCESS in caso di esito positivo o un errore di memoria in caso di esito negativo.

Commenti

L'elemento DefaultClock.ReferenceCount interno viene inizializzato in uno dalla funzione KsAllocateDefaultClock . L'elemento viene incrementato e decrementato man mano che ogni notifica DPC viene accodata e completata. Quando la struttura deve essere liberata, l'elemento viene usato per determinare se il proprietario dell'orologio deve liberare la struttura o se un DPC in sospeso deve liberarlo in modo asincrono.

Quando l'orologio non è più necessario, il driver deve chiamare KsFreeDefaultClock per rilasciare tutte le risorse allocate per l'uso con l'orologio.

Requisiti

   
Piattaforma di destinazione Universale
Intestazione ks.h (include Ks.h)
Libreria Ks.lib
IRQL PASSIVE_LEVEL

Vedi anche

KsAllocateDefaultClockEx

KsFreeDefaultClock