KsCreateDefaultClock-Funktion (ks.h)
Bei einer IRP_MJ_CREATE Anforderung erstellt die KsCreateDefaultClock-Funktion eine Standarduhr, die die Systemuhr als Zeitbasis verwendet und das IoGetCurrentIrpStackLocation(Irp)->FileObject mithilfe einer internen Dispatchtabelle (KSDISPATCH_TABLE) der Uhr zuordnet. Schließt die IRP nicht ab oder legt die status im IRP fest.
Die KsCreateDefaultClock-Funktion kann nur bei PASSIVE_LEVEL aufgerufen werden.
Syntax
KSDDKAPI NTSTATUS KsCreateDefaultClock(
[in] PIRP Irp,
[in] PKSDEFAULTCLOCK DefaultClock
);
Parameter
[in] Irp
Gibt den IRP an, für den die Anforderung zum Erstellen von Uhren verarbeitet wird.
[in] DefaultClock
Gibt eine standardtaktische Standarduhrstruktur an, die für alle instance der Standarduhr für das übergeordnete Element freigegeben wird.
Rückgabewert
Die KsCreateDefaultClock-Funktion gibt bei erfolgreicher Ausführung STATUS_SUCCESS oder bei Erfolg einen Fehler zurück.
Hinweise
Die Uhr kann nach der Verwendung von KsAllocateDefaultClock erstellt werden, um die internen Strukturen für eine Standarduhr instance zu erstellen und zu initialisieren. Nach der Initialisierung können viele Dateiobjekte mit der gleichen zugrunde liegenden Standarduhr instance erstellt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | ks.h (ks.h einschließen) |
| Bibliothek | Ks.lib |