共用方式為

REQUEST_OPLOCK_INPUT_BUFFER 結構 (winioctl.h)

  • 發行項

包含要求 oplock (oplock) 或以 FSCTL_REQUEST_OPLOCK 控件程式代碼認可 oplock 中斷的資訊。

語法

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

成員

StructureVersion

所使用的 REQUEST_OPLOCK_INPUT_BUFFER 結構版本。 將此成員設定為 REQUEST_OPLOCK_CURRENT_VERSION。

StructureLength

這個結構的長度，以位元組為單位。 必須設為 sizeof(REQUEST_OPLOCK_INPUT_BUFFER)。

RequestedOplockLevel

下列 oplock 層級值的有效組合。

值 意義
OPLOCK_LEVEL_CACHE_READ
 允許用戶端快取讀取。 可能會授與多個用戶端。
OPLOCK_LEVEL_CACHE_HANDLE
 允許用戶端快取開啟的句柄。 可能會授與多個用戶端。
OPLOCK_LEVEL_CACHE_WRITE
 允許用戶端快取寫入和位元組範圍鎖定。 只能授與單一用戶端。
 

這些值的有效組合如下所示：

  • 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
如需這些值組合的詳細資訊，請參閱 FSCTL_REQUEST_OPLOCK。

Flags

下列要求旗標值的有效組合。

值 意義
REQUEST_OPLOCK_INPUT_FLAG_REQUEST
 要求新的 oplock。 將此旗標與 REQUEST_OPLOCK_INPUT_FLAG_ACK 一起設定無效，而且會導致要求失敗並 ERROR_INVALID_PARAMETER。
REQUEST_OPLOCK_INPUT_FLAG_ACK
 認可 oplock 中斷。 將此旗標與 REQUEST_OPLOCK_ INPUT_FLAG_REQUEST 一起設定無效，且會導致要求失敗，並 ERROR_INVALID_PARAMETER。

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
標頭 winioctl.h (包含 Windows.h)

另請參閱

FSCTL_REQUEST_OPLOCK

REQUEST_OPLOCK_OUTPUT_BUFFER