OPLOCK_KEY_CONTEXT 結構 (ntddk.h)
OPLOCK_KEY_CONTEXT結構會從IoGetOplockKeyContextEx傳回。 此結構包含特定檔案物件的 oplock 索引鍵。
語法
typedef struct _OPLOCK_KEY_CONTEXT {
USHORT Version;
USHORT Flags;
GUID ParentOplockKey;
GUID TargetOplockKey;
ULONG Reserved;
} OPLOCK_KEY_CONTEXT, *POPLOCK_KEY_CONTEXT;
成員
Version
oplock 金鑰版本。 版本會設定為下列其中一個值：
| 值 | 意義 |
|---|---|
| OPLOCK_KEY_VERSION_WIN7 | 這是 Windows 7 oplock 機碼。 |
| OPLOCK_KEY_VERSION_WIN8 | 這是 Windows 8 oplock 金鑰。 |
Flags
一組旗標，表示 oplock 機碼類型。 旗標 會設定為下列其中一個或兩個值：
| 值 | 意義 |
|---|---|
| OPLOCK_KEY_FLAG_PARENT_KEY | ParentOplockKey 中存在有效的 oplock 金鑰。 |
| OPLOCK_KEY_FLAG_TARGET_KEY | TargetOplockKey 中存在有效的 oplock 金鑰。 |
ParentOplockKey
表示父 Oplock 索引鍵值的 GUID 。
TargetOplockKey
表示目標 oplock 索引鍵值的 GUID 。
Reserved
備註
如果在 IRP_MJ_CREATE 要求期間要求檔案的 oplock，則支援 oplock 的文件系統會將 oplock 密鑰內容附加至所建立的檔案物件。 oplock 索引鍵內容稍後可透過 OPLOCK_KEY_CONTEXT 結構的指標取得。 OPLOCK_KEY_CONTEXT結構是從呼叫 IoGetOplockKeyContextEx 傳回。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 8 開始，即可使用此結構。 |
| 標頭 | ntddk.h (包含 Ntddk.h) |