KsAllocateDefaultClock-Funktion (ks.h)
Die KsAllocateDefaultClock--Funktion weist die Standarduhrstruktur zu und initialisiert sie.
Syntax
KSDDKAPI NTSTATUS KsAllocateDefaultClock(
[out] PKSDEFAULTCLOCK *DefaultClock
);
Parameter
[out] DefaultClock
Gibt die vom Aufrufer zugewiesene freigegebene Standarduhrstruktur an. Die aktuelle Uhrzeit wird auf Null festgelegt, und der Zustand wird auf KSSTATE_STOP festgelegt. Nach erfolgreichem Abschluss dieser Routine enthält die von diesem Zeiger angegebene Struktur einen Verweis auf die Standarduhr. Die zurückgegebenen Daten sollten als undurchsichtig behandelt und für die Systemverwendung reserviert werden.
Rückgabewert
Die KsAllocateDefaultClock--Funktion gibt STATUS_SUCCESS bei erfolgreicher Ausführung oder bei Erfolg einen Speicherfehler zurück.
Bemerkungen
Das interne DefaultClock.ReferenceCount-Element wird durch die funktion KsAllocateDefaultClock initialisiert. Das Element wird inkrementiert und dekrementiert, da jeder Benachrichtigungs-DPC in die Warteschlange gestellt und abgeschlossen wird. Wenn die Struktur freigegeben werden soll, wird das Element verwendet, um zu bestimmen, ob der Besitzer der Uhr die Struktur freigeben soll oder ob ein ausstehender DPC es asynchron freigeben soll.
Wenn die Uhr nicht mehr benötigt wird, muss der Treiber KsFreeDefaultClock- aufrufen, um alle ressourcen freizugeben, die für die Verwendung mit der Uhr zugeordnet sind.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Header- | ks.h (enthalten Ks.h) |
| Library | Ks.lib |
| IRQL- | PASSIVE_LEVEL |