KsSetInformationFile-Funktion (ks.h)

Die KsSetInformationFile-Funktion führt einen Informationssatz für das angegebene Dateiobjekt aus. Die Funktion versucht, FastIoDispatch nach Möglichkeit zu verwenden, oder sie generiert eine Information, die für das Geräteobjekt festgelegt ist.

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 den Ort an, an dem die Dateiinformationen abgelegt werden sollen. Es wird davon ausgegangen, dass die Dateiinformationen eine gültige oder überprüfte Adresse sind.

[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 dies erfolgreich war, oder wenn sie nicht erfolgreich ist, gibt sie einen set-Fehler zurück.

Hinweise

Die KsSetInformationFile-Funktion sollte nur verwendet werden, wenn der Satz zu einer tatsächlichen Anforderung an den zugrunde liegenden Treiber führen würde, ohne komplexe Vorgänge, die zusätzliche Parameter an den Treiber senden müssen, z. B. Umbenennen, Löschen und Vervollständigung. FilePositionInformation würde beispielsweise 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