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
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Intestazione | ks.h (include Ks.h) |
| Libreria | Ks.lib |
| IRQL | PASSIVE_LEVEL |