다음을 통해 공유

REQUEST_OPLOCK_INPUT_BUFFER 구조체(winioctl.h)

  • 아티클

편의적 잠금(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