IoCreateStreamFileObjectLite-Funktion (ntifs.h)
Die IoCreateStreamFileObjectLite-Routine erstellt ein neues Streamdateiobjekt, bewirkt jedoch nicht, dass eine IRP_MJ_CLEANUP Anforderung an den Dateisystemtreiberstapel gesendet wird.
Syntax
PFILE_OBJECT IoCreateStreamFileObjectLite(
[in, optional] PFILE_OBJECT FileObject,
[in, optional] PDEVICE_OBJECT DeviceObject
);
Parameter
[in, optional] FileObject
Ein Zeiger auf das Dateiobjekt, mit dem die neue Streamdatei verknüpft ist. Dieser Parameter ist optional und kann NULL sein.
[in, optional] DeviceObject
Ein Zeiger auf ein Geräteobjekt für das Gerät, auf dem die Streamdatei geöffnet werden soll. Wenn der Aufrufer einen Wert ungleich NULL für FileObject angibt, wird der Wert von DeviceObject ignoriert. Andernfalls muss der Aufrufer einen Wert ungleich NULL für DeviceObject angeben.
Rückgabewert
IoCreateStreamFileObjectLite gibt einen Zeiger auf das neu erstellte Streamdateiobjekt zurück.
Hinweise
Dateisysteme rufen IoCreateStreamFileObjectLite auf, um ein neues Streamdateiobjekt zu erstellen. Ein Streamdateiobjekt ist mit einem gewöhnlichen Dateiobjekt identisch, mit der Ausnahme, dass das FO_STREAM_FILE Dateiobjektflag festgelegt ist.
Ein Streamdateiobjekt wird häufig verwendet, um einen internen Datenstrom für ein volume darzustellen, das vom Dateisystem bereitgestellt wird. Diese virtuelle Volumedatei ermöglicht es dem Dateisystem, die Struktur des Volumes auf dem Datenträger anzuzeigen, zu ändern und zwischenzuspeichern, als wäre es eine normale Datei. In diesem Fall gibt der DeviceObject-Parameter im Aufruf von IoCreateStreamFileObjectLite das Volume device object (VDO) für das Volume an.
Ein Streamdateiobjekt kann auch verwendet werden, um einen alternativen Datenstrom für den Zugriff auf Metadaten wie erweiterte Attribute oder Sicherheitsbeschreibungen für eine bereits geöffnete Datei darzustellen. In diesem Fall gibt der FileObject-Parameter im Aufruf von IoCreateStreamFileObjectLite ein vorhandenes Dateiobjekt für die Datei an. Das neu erstellte Streamdateiobjekt ermöglicht es dem Dateisystem, die Metadaten der Datei anzuzeigen, zu ändern und zwischenzuspeichern, als ob es sich um eine normale Datei handelt.
Wenn das Streamdateiobjekt nicht mehr benötigt wird, muss der Aufrufer seine Verweisanzahl durch Aufrufen von ObDereferenceObject verringern. Wenn die Verweisanzahl des Streamdateiobjekts null erreicht, wird eine IRP_MJ_CLOSE Anforderung an den Dateisystemtreiberstapel für das Volume gesendet.
Dateisystemfiltertreiberautoren sollten beachten, dass IoCreateStreamFileObject im Gegensatz zu IoCreateStreamFileObjectLite nicht bewirkt, dass eine IRP_MJ_CLEANUP Anforderung an den Dateisystemtreiberstapel gesendet wird. Aus diesem Grund und da Dateisysteme häufig Streamdateiobjekte als Nebeneffekt von Vorgängen als IRP_MJ_CREATE erstellen, ist es für Filtertreiber schwierig, die Erstellung von Streamdateiobjekten zuverlässig zu erkennen. Daher sollten Filtertreiber erwarten, dass IRP_MJ_CLOSE Anforderungen für zuvor nicht angezeigte Dateiobjekte empfangen werden.
Wenn ein Poolzuordnungsfehler auftritt, löst IoCreateStreamFileObjectLite eine STATUS_INSUFFICIENT_RESOURCES Ausnahme aus.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 |
| Zielplattform | Universell |
| Header | ntifs.h (include Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |