CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT 구조체(ntifs.h)

  • 아티클

CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT 구조에는 CSV(클러스터 공유 볼륨) 파일 시스템으로 보낼 수 있는 ECP(추가 만들기 매개 변수) 컨텍스트가 포함되어 이 열기에 도착하는 IO를 처리하는 방법에 대한 속성을 설정합니다.

구문

typedef struct _CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT {
  SIZE_T Size;
  ULONG  PauseTimeoutInSeconds;
  ULONG  Flags;
} CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT, *PCSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT;

멤버

Size

이 구조체의 크기(바이트)입니다.

PauseTimeoutInSeconds

CSV 볼륨 일시 중지 시 CSVFS가 이 파일 개체에 대해 발급된 IO를 보류 중인 상태로 유지할 수 있는 시간(초)입니다. 시간이 만료되면 CSV는 상태 STATUS_CSV_IO_PAUSE_TIMEOUT 사용하여 이 파일 개체에서 발급된 모든 IO를 완료합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

값 의미
0xFFFFFFFF 시간 제한이 없고 기본 동작이 요청됨을 나타냅니다.
0 CSV는 IO를 일시 중지하지 않고 IO를 즉시 완료합니다.
다른 모든 값 CSV는 다른 모든 값을 10초의 배수로 반올림하고 이 값을 시간 제한으로 사용합니다. 지원되는 최대 제한 시간 값은 30분입니다. 제공된 값이 30분보다 크면 CSV는 자동으로 값을 최대값으로 설정합니다.

Flags

set 속성 플래그입니다. 이 멤버는 다음 플래그의 비트 OR일 수 있습니다.

플래그 의미
CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR 이 파일 열기는 조정 노드에서만 유효해야 한다고 CSVFS에 알릴 수 있습니다. 열기가 CSVFS에 오고 노드가 조정 노드가 아닌 경우 열기가 실패합니다. 파일이 열리고 조정 노드가 이동되면 열려 있는 파일이 무효화됩니다. 이 플래그는 파일이 CSVFS에서 직접 열리는 경우에만 사용되며 SMB를 통해 파일을 열 때 무시됩니다.

플래그의 하위 16비트 는 CSV가 인식하지 못하는 경우 만들기가 STATUS_INVALID_PARAMETER 실패하게 만드는 플래그에 대한 것입니다. 상위 16비트 는 CSVFS가 처리 방법을 모르는 경우 자동으로 무시되는 플래그에 대한 것입니다.

설명

시스템 정의 GUID_ECP_CSV_SET_HANDLE_PROPERTIES 값은 FltAllocateExtraCreateParameter 및 FsRtlRemoveExtraCreateParameter와 같은 ECP 관련 지원 루틴을 호출할 때 이 ECP 컨텍스트 구조와 함께 사용됩니다.

자세한 내용은 추가 만들기 매개 변수 소개 를 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8
머리글 ntifs.h