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 값입니다.

값	의미
REQUEST_OPLOCK_OUTPUT_FLAG_ACK_REQUIRED	승인이 필요하고 OriginalOplockLevel 에 설명된 oplock은 중단이 성공적으로 승인될 때까지 계속 유효합니다.
REQUEST_OPLOCK_OUTPUT_FLAG_MODES_PROVIDED	ShareMode 및 AccessMode 멤버에 각각 oplock 중단을 일으키는 요청의 공유 및 액세스 플래그가 포함되어 있음을 나타냅니다. 자세한 내용은 주의 섹션을 참조하세요.

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 포함)

추가 정보

FSCTL_REQUEST_OPLOCK

Oplock 의미 체계

REQUEST_OPLOCK_INPUT_BUFFER