IRP_MJ_SET_INFORMATION
Gerätetreiber können optional eine IRP_MJ_SET_INFORMATION-Anforderung verarbeiten.
Sendebedingungen
Das Betriebssystem sendet eine IRP_MJ_SET_INFORMATION Anforderung zum Festlegen von Metadaten zu einer Datei oder einem Dateihandle. Wenn beispielsweise ein Treiber ZwSetInformationFile aufruft, sendet das Betriebssystem eine IRP_MJ_SET_INFORMATION Anforderung.
Eingabeparameter
Das Parameters.SetFile.FileInformationClass-Element ist eine FILE_INFORMATION_CLASS Konstante, die den Typ der festzulegenden Metadaten angibt. Weitere Informationen zu den Metadatentypen finden Sie im FileInformationClass-Parameter von ZwSetInformationFile.
Das Parameters.SetFile.Length-Element gibt die Länge des Puffers an, auf den das AssociatedIrp.SystemBuffer-Element verweist.
AssociatedIrp.SystemBuffer verweist auf den Puffer, der die neue Informationseinstellung enthält. Der Wert von Parameters.SetFile.FileInformationClass bestimmt das Format der zurückzugebenden Daten (eine FILE_XXX_INFORMATION-Struktur ). Weitere Informationen zu den Metadatenformaten finden Sie in der FILE_INFORMATION_CLASS-Enumeration .
Ausgabeparameter
Keine
Vorgang
Treiber sind nicht erforderlich, um diese Anforderung zu verarbeiten, und Treiber, die nicht erforderlich sind, um jeden möglichen Wert von Parameters.SetFile.FileInformationClass zu verarbeiten. Die Dispatchroutine des Treibers sollte einen Fehlercode wie STATUS_INVALID_DEVICE_REQUEST für alle Werte zurückgeben, die nicht verarbeitet werden.
Nicht alle möglichen Werte von FILE_INFORMATION_CLASS können auftreten.
Anforderungen
Header |
Wdm.h (einschließlich Wdm.h, Ntddk.h oder Ntifs.h) |