Bagikan melalui

struktur REQUEST_OPLOCK_INPUT_BUFFER (winioctl.h)

  • Artikel

Berisi informasi untuk meminta kunci oportunistik (oplock) atau untuk mengakui jeda oplock dengan kode kontrol FSCTL_REQUEST_OPLOCK .

Sintaks

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

Anggota

StructureVersion

Versi struktur REQUEST_OPLOCK_INPUT_BUFFER yang sedang digunakan. Atur anggota ini ke REQUEST_OPLOCK_CURRENT_VERSION.

StructureLength

Panjang struktur ini, dalam byte. Harus diatur ke sizeof(REQUEST_OPLOCK_INPUT_BUFFER).

RequestedOplockLevel

Kombinasi yang valid dari nilai tingkat oplock berikut.

Nilai Makna
OPLOCK_LEVEL_CACHE_READ
 Memungkinkan klien untuk menyimpan cache bacaan. Dapat diberikan kepada beberapa klien.
OPLOCK_LEVEL_CACHE_HANDLE
 Memungkinkan klien untuk menyimpan handel terbuka. Dapat diberikan kepada beberapa klien.
OPLOCK_LEVEL_CACHE_WRITE
 Memungkinkan klien untuk membuat cache tulis dan kunci rentang byte. Hanya dapat diberikan kepada satu klien.
 

Kombinasi nilai-nilai ini yang valid adalah sebagai berikut:

  • 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
Untuk informasi selengkapnya tentang kombinasi nilai ini, lihat FSCTL_REQUEST_OPLOCK.

Flags

Kombinasi yang valid dari nilai bendera permintaan berikut.

Nilai Makna
REQUEST_OPLOCK_INPUT_FLAG_REQUEST
 Minta oplock baru. Mengatur bendera ini bersama dengan REQUEST_OPLOCK_INPUT_FLAG_ACK tidak valid dan akan menyebabkan permintaan gagal dengan ERROR_INVALID_PARAMETER.
REQUEST_OPLOCK_INPUT_FLAG_ACK
 Pengakuan tentang pembobolan oplock. Mengatur bendera ini bersama dengan REQUEST_OPLOCK_ INPUT_FLAG_REQUEST tidak valid dan akan menyebabkan permintaan gagal dengan ERROR_INVALID_PARAMETER.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Header winioctl.h (termasuk Windows.h)

Lihat juga

FSCTL_REQUEST_OPLOCK

REQUEST_OPLOCK_OUTPUT_BUFFER