Freigeben über

REQUEST_OPLOCK_INPUT_BUFFER-Struktur (winioctl.h)

  • Artikel

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