REQUEST_OPLOCK_INPUT_BUFFER-Struktur (winioctl.h)

Artikel
08/27/2023

Enthält die Informationen zum Anfordern einer opportunistischen Sperre (Oplock) oder zum Bestätigen einer Oplock-Unterbrechung mit dem FSCTL_REQUEST_OPLOCK-Steuerungscode.

Syntax

typedef struct _REQUEST_OPLOCK_INPUT_BUFFER {
  WORD  StructureVersion;
  WORD  StructureLength;
  DWORD RequestedOplockLevel;
  DWORD Flags;
} REQUEST_OPLOCK_INPUT_BUFFER, *PREQUEST_OPLOCK_INPUT_BUFFER;

Member

StructureVersion

Die Version der REQUEST_OPLOCK_INPUT_BUFFER-Struktur , die verwendet wird. Legen Sie dieses Element auf REQUEST_OPLOCK_CURRENT_VERSION fest.

StructureLength

Die Länge dieser Struktur in Bytes. Muss auf sizeof(REQUEST_OPLOCK_INPUT_BUFFER) festgelegt sein.

RequestedOplockLevel

Eine gültige Kombination der folgenden Werte der Oplock-Ebene.

Wert	Bedeutung
OPLOCK_LEVEL_CACHE_READ	Ermöglicht Clients das Zwischenspeichern von Lesevorgängen. Kann mehreren Clients gewährt werden.
OPLOCK_LEVEL_CACHE_HANDLE	Ermöglicht Clients das Zwischenspeichern geöffneter Handles. Kann mehreren Clients gewährt werden.
OPLOCK_LEVEL_CACHE_WRITE	Ermöglicht Clients das Zwischenspeichern von Schreibvorgängen und Bytebereichssperren. Kann nur einem einzelnen Client gewährt werden.

Gültige Kombinationen dieser Werte sind wie folgt:

OPLOCK_LEVEL_CACHE_READ
OPLOCK_LEVEL_CACHE_READ | OPLOCK_LEVEL_CACHE_HANDLE
OPLOCK_LEVEL_CACHE_READ | OPLOCK_LEVEL_CACHE_WRITE
OPLOCK_LEVEL_CACHE_READ | OPLOCK_LEVEL_CACHE_WRITE | OPLOCK_LEVEL_CACHE_HANDLE

Weitere Informationen zu diesen Wertkombinationen finden Sie unter FSCTL_REQUEST_OPLOCK.

Flags

Eine gültige Kombination der folgenden Anforderungsflagwerte.

Wert	Bedeutung
REQUEST_OPLOCK_INPUT_FLAG_REQUEST	Fordern Sie einen neuen Oplock an. Das Festlegen dieses Flags zusammen mit REQUEST_OPLOCK_INPUT_FLAG_ACK ist ungültig und führt dazu, dass die Anforderung mit ERROR_INVALID_PARAMETER fehlschlägt.
REQUEST_OPLOCK_INPUT_FLAG_ACK	Bestätigung eines Oplock-Umbruchs. Das Festlegen dieses Flags zusammen mit REQUEST_OPLOCK_ INPUT_FLAG_REQUEST ist ungültig und führt dazu, dass die Anforderung mit ERROR_INVALID_PARAMETER fehlschlägt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Kopfzeile	winioctl.h (einschließlich Windows.h)

Weitere Informationen

FSCTL_REQUEST_OPLOCK

REQUEST_OPLOCK_OUTPUT_BUFFER

Freigeben über