DUAL_OPLOCK_KEY_ECP_CONTEXT-Struktur (ntifs.h)

Artikel
03/01/2024

Die DUAL_OPLOCK_KEY_ECP_CONTEXT-Struktur enthält den zusätzlichen Create-Parameterkontext für einen dualen Oplock-Schlüssel. Oplocks-Schlüssel für ein Ziel- und ein übergeordnetes Dateiobjekt können in dieser Struktur festgelegt werden.

Syntax

typedef struct _DUAL_OPLOCK_KEY_ECP_CONTEXT {
  GUID    ParentOplockKey;
  GUID    TargetOplockKey;
  BOOLEAN ParentOplockKeySet;
  BOOLEAN TargetOplockKeySet;
} DUAL_OPLOCK_KEY_ECP_CONTEXT, *PDUAL_OPLOCK_KEY_ECP_CONTEXT;

Member

ParentOplockKey

Eine GUID , die den wert des übergeordneten Oplockschlüssels darstellt.

TargetOplockKey

Eine GUID , die den Zielschlüsselwert für oplock darstellt.

ParentOplockKeySet

Legen Sie diesen Wert auf TRUE fest, wenn ParentOplockKey eine gültige GUID für den oplock-Schlüssel des übergeordneten Elements enthält.

TargetOplockKeySet

Legen Sie diesen Wert auf TRUE fest, wenn TargetOplockKey eine gültige GUID für den oplock-Schlüssel des Ziels enthält.

Hinweise

Die DUAL_OPLOCK_KEY_ECP_CONTEXT-Struktur stellt duale Oplockschlüssel bereit, um Oplockanforderungen für Dateien und Verzeichnisse zuzulassen. Wie die OPLOCK_KEY_ECP_CONTEXT-Struktur wird DUAL_OPLOCK_KEY_ECP_CONTEXT in einer zusätzlichen Create-Parameterliste (ECP_LIST) festgelegt und später einem Dateiobjekt bei der Verarbeitung von IRP_MJ_CREATE durch einen Dateisystem- oder Dateisystemfiltertreiber zugeordnet.

Der Wert GUID_ECP_DUAL_OPLOCK_KEY wird beim Aufrufen von Supportroutinen wie FsRtlAllocateExtraCreateParameter, FsRtlInitializeExtraCreateParameter oder FltRemoveExtraCreateParameter verwendet.