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 Zeit wird auf 0 festgelegt, und der Zustand wird auf KSSTATE_STOP festgelegt. Nach erfolgreichem Abschluss dieser Routine enthält die durch diesen 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 bei erfolgreicher Ausführung STATUS_SUCCESS oder bei Erfolg einen Speicherfehler zurück.
Hinweise
Das interne DefaultClock.ReferenceCount-Element wird von der KsAllocateDefaultClock-Funktion als eines initialisiert. Das Element wird inkrementiert und dekrementiert, wenn jede 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 sie 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 zugewiesen sind.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | ks.h (einschließlich Ks.h) |
| Bibliothek | Ks.lib |
| IRQL | PASSIVE_LEVEL |