CSV_CONTROL_OP-Enumeration (ntifs.h)

Gibt den Typ des CSV-Steuerungsvorgangs (Cluster Shared Volume) an, der mit dem FSCTL_CSV_CONTROL-Steuerelementcode verwendet werden soll.

Syntax

typedef enum _CSV_CONTROL_OP {
  CsvControlStartRedirectFile = 0x02,
  CsvControlStopRedirectFile = 0x03,
  CsvControlQueryRedirectState = 0x04,
  CsvControlQueryFileRevision = 0x06,
  CsvControlQueryMdsPath = 0x08,
  CsvControlQueryFileRevisionFileId128 = 0x09,
  CsvControlQueryVolumeRedirectState = 0x0a,
  CsvControlEnableUSNRangeModificationTracking = 0x0d,
  CsvControlMarkHandleLocalVolumeMount = 0x0e,
  CsvControlUnmarkHandleLocalVolumeMount = 0x0f,
  CsvControlGetCsvFsMdsPathV2 = 0x12,
  CsvControlDisableCaching = 0x13,
  CsvControlEnableCaching = 0x14,
  CsvControlStartForceDFO = 0x15,
  CsvControlStopForceDFO = 0x16,
  CsvControlQueryMdsPathNoPause = 0x17,
  CsvControlSetVolumeId = 0x18,
  CsvControlQueryVolumeId = 0x19
} CSV_CONTROL_OP, *PCSV_CONTROL_OP;

Konstanten

Hinweise

Eine Alternative zum Aufrufen des FSCTL_CSV_CONTROL-Steuerelementcodes mit dieser Enumeration ist die Verwendung der CSV_CONTROL_PARAM-Struktur , die einen Member dieses Enumerationstyps kapselt.

CsvControlStartForceDFO und CsvControlStopForceDFO

Wenn ein Dateiobjekt in CSVFS geöffnet wird, öffnet CSVFS im down-level File System (NTFS oder REFS) ein down-level File Object (DFO), das jedem geöffneten Benutzer entspricht. Dieses Dateiobjekt wird als Teil einer Anwendung geöffnet, die eine Datei in CSVFS öffnet, und wird geschlossen, wenn die Anwendung das Handle für das Dateiobjekt in CSVFS schließt. Intern öffnet CSVFS ein zusätzliches Dateiobjekt namens Paging File Object (PFO), das für alle Geöffnete derselben Datei in CSVFS freigegeben wird. Standardmäßig verwendet CSVFS sie für viele Vorgänge, z. B. die folgenden:

• Oplock-Aushandlung
• Bytebereichssperren
• Weiterleitung von Paging-E/A

Einige Filterlösungen markieren das Handle möglicherweise auf besondere Weise und erwarten dann, dass alle Lese- und Schreibvorgänge von CSVFS auf der entsprechenden DFO-Ebene weitergeleitet werden. Eine Anwendung kann erzwingen, dass CSVFS mit der Weiterleitung von E/A auf down-Level auf DFO beginnt, indem csvControlStartForceDFO gesendet wird. Später kann die Anwendung CsvControlStopForceDFO verwenden, um das Standardverhalten zu rückgängig machen. Das Schließen des Handles, das zum Senden von CsvControlStartForceDFO verwendet wurde, rückgängig machen implizit zurück, als ob die Anwendung CsvControlStopForceDFO gesendet hätte.

CsvControlSetVolumeId und CsvControlQueryVolumeId

Mit diesen Steuerelementen können Dateisystem-Minifilter, die an das untere Dateisystem unterhalb von CSVFS angefügt sind, die CSV-Volume-GUID erlernen. Die Physische Clusterdatenträgerressource legt diese GUID fest, nachdem das down-level-Dateisystem eingebunden wurde, sodass sie nicht verfügbar ist, wenn der Filter während der Einbindung angefügt wird. Während der Filteranfügung kann der Dateisystemminifilter CsvControlQueryVolumeId ausgeben, um abzufragen, ob die GUID bereits verfügbar ist. Das Steuerelement muss an den Anfang des Stapels gesendet werden, um sicherzustellen, dass csvflt es empfängt . Wenn die Volume-GUID noch nicht verfügbar ist, gibt csvflt STATUS_UNSUCCESSFUL zurück. Der Filter sollte nicht anfügen, wenn die Volume-GUID noch nicht verfügbar ist.

Zu einem späteren Zeitpunkt sendet die Ressource für physische Datenträger CsvControlSetVolumeId mit der Volume-GUID. Jeder Filter im Stapel kann das CsvControlSetVolumeId-Steuerelement verwenden, um die Volume-GUID zu speichern. Filter dürfen dieses Steuerelement nicht abschließen. Stattdessen sollten sie zulassen, dass sie den Stapel heruntergeht, sodass andere Filter die Möglichkeit haben, die GUID zu speichern.

Anforderungen

Weitere Informationen

Enumerationen in der Dateiverwaltung

CSV_CONTROL_PARAM

CSV_QUERY_FILE_REVISION

CSV_QUERY_MDS_PATH

CSV_QUERY_REDIRECT_STATE

FSCTL_CSV_CONTROL