KsSetInformationFile-Funktion (ks.h)

Artikel
02/07/2025

Die KsSetInformationFile--Funktion führt einen Informationssatz für das angegebene Dateiobjekt aus. Die Funktion versucht, FastIoDispatch- zu verwenden, oder es generiert einen Informationssatz für das Geräteobjekt.

Syntax

KSDDKAPI NTSTATUS KsSetInformationFile(
  [in] PFILE_OBJECT           FileObject,
  [in] PVOID                  FileInformation,
  [in] ULONG                  Length,
  [in] FILE_INFORMATION_CLASS FileInformationClass
);

Parameter

[in] FileObject

Gibt das Dateiobjekt an, für das die Standardinformationen festgelegt werden sollen.

[in] FileInformation

Gibt die Stelle an, an der die Dateiinformationen abgelegt werden sollen. Die Dateiinformationen werden als gültige adresse oder probed angenommen.

[in] Length

Gibt die richtige Länge des FileInformation- Puffers an.

[in] FileInformationClass

Gibt die Klasse der festzulegenden Informationen an.

Rückgabewert

Die KsSetInformationFile--Funktion gibt STATUS_SUCCESS zurück, wenn die Funktion erfolgreich verläuft, oder wenn die Funktion nicht erfolgreich ist, wird ein Satzfehler zurückgegeben.

Bemerkungen

Die KsSetInformationFile--Funktion sollte nur verwendet werden, wenn der Satz zu einer tatsächlichen Anforderung an den zugrunde liegenden Treiber führen würde, nicht einschließlich komplexer Vorgänge, die zusätzliche Parameter an den Treiber senden müssen, z. B. Umbenennen, Löschen und Abschließen. Beispielsweise würde FilePositionInformation eine solche Anforderung nicht generieren und sollte nicht verwendet werden. Es wird davon ausgegangen, dass der Aufrufer den Zugriff auf die Datei für Vorgänge für ein FO_SYNCHRONOUS_IO Dateiobjekt serialisiert.

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Header-	ks.h (enthalten Ks.h)
Library	Ks.lib

Freigeben über