REQUEST_OPLOCK_OUTPUT_BUFFER 구조체(winioctl.h)
FSCTL_REQUEST_OPLOCK 제어 코드에서 반환된 편의적 잠금(oplock) 정보를 포함합니다.
구문
typedef struct _REQUEST_OPLOCK_OUTPUT_BUFFER {
WORD StructureVersion;
WORD StructureLength;
DWORD OriginalOplockLevel;
DWORD NewOplockLevel;
DWORD Flags;
ACCESS_MASK AccessMode;
WORD ShareMode;
} REQUEST_OPLOCK_OUTPUT_BUFFER, *PREQUEST_OPLOCK_OUTPUT_BUFFER;
멤버
StructureVersion
사용 중인 REQUEST_OPLOCK_OUTPUT_BUFFER 구조체의 버전입니다.
StructureLength
이 구조체의 길이(바이트)입니다.
OriginalOplockLevel
손상된 oplock의 수준을 나타내는 하나 이상의 OPLOCK_LEVEL_CACHE_XXX 값입니다.
가능한 값은 REQUEST_OPLOCK_INPUT_BUFFER 구조체의 RequestedOplockLevel 멤버를 참조하세요.
NewOplockLevel
이 버퍼를 반환하는 작업에 따라 oplock이 손상되는 수준 또는 부여할 수 있는 oplock 수준을 나타내는 하나 이상의OPLOCK_LEVEL_CACHE_XXX 값입니다.
가능한 값은 REQUEST_OPLOCK_INPUT_BUFFER 구조체의 RequestedOplockLevel 멤버를 참조하세요.
Flags
하나 이상의 REQUEST_OPLOCK_OUTPUT_FLAG_XXX 값입니다.
AccessMode
REQUEST_OPLOCK_OUTPUT_FLAG_MODES_PROVIDED 플래그가 설정되고 oplock 중단 시 OPLOCK_LEVEL_CACHE_HANDLE 수준이 손실되는 경우 에는 중단을 일으키는 요청의 액세스 모드가 포함됩니다.
ShareMode
REQUEST_OPLOCK_OUTPUT_FLAG_MODES_PROVIDED 플래그가 설정되고 oplock 중단 시 OPLOCK_LEVEL_CACHE_HANDLE 수준이 손실되는 경우 에는 중단을 일으키는 요청의 공유 모드가 포함됩니다.
설명
REQUEST_OPLOCK_OUTPUT_FLAG_MODES_PROVIDED 플래그는 ShareMode 및 AccessMode 필드에 각각 oplock 중단을 일으키는 요청의 공유 및 액세스 플래그가 포함되어 있음을 나타냅니다. 이 정보는 OPLOCK_LEVEL_CACHE_HANDLE 수준이 손실되는 중단에 제공될 수 있으며 공유 및 액세스 모드가 중단을 일으키는 핸들과 충돌하는 핸들을 닫을 수 있는 호출자에게 유용할 수 있습니다. 이렇게 하면 적어도 일부 핸들 캐시 상태를 유지할 수 있습니다. OPLOCK_LEVEL_CACHE_HANDLE 수준이 손실되는 모든 중단에는 이 플래그가 설정되지 않습니다. 이 플래그가 설정되는 기본 사례는 중단이 ERROR_SHARING_VIOLATION 실패하지 않도록 OPLOCK_LEVEL_CACHE_HANDLE oplock을 중단해야 하는 만들기 작업의 결과인 경우입니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 R2 [데스크톱 앱만 해당] |
| 머리글 | winioctl.h(Windows.h 포함) |