다음을 통해 공유

MARK_HANDLE_INFO 구조체(ntifs.h)

  • 아티클

MARK_HANDLE_INFO 구조체는 FSCTL_MARK_HANDLE 제어 코드 요청 중에 입력 버퍼로 전달됩니다.

통사론

typedef struct _MARK_HANDLE_INFO {
  union {
    ULONG UsnSourceInfo;
    ULONG CopyNumber;
  } DUMMYUNIONNAME;
  ULONG  UsnSourceInfo;
  HANDLE VolumeHandle;
  ULONG  HandleInfo;
} MARK_HANDLE_INFO, *PMARK_HANDLE_INFO;

회원

DUMMYUNIONNAME

DUMMYUNIONNAME.UsnSourceInfo

아래 UsnSourceInfo 참조하세요.

DUMMYUNIONNAME.CopyNumber

중복 미디어에 있는 파일에서 읽을 때 읽을 파일의 복사본을 식별합니다.

UsnSourceInfo

선택적 USN(업데이트 시퀀스 번호) 원본 정보 플래그입니다. 이러한 값을 설정하려면 볼륨 DASD 핸들을 VolumeHandle 필드에 지정해야 합니다. 다음 값의 조합일 수 있습니다.

기 의미
USN_SOURCE_DATA_MANAGEMENT 서비스가 파일의 어떤 부분의 외부 보기를 수정하지 않습니다. 일반적인 경우는 외부 스토리지 간에 데이터를 이동하는 HSM입니다.
USN_SOURCE_AUXILIARY_DATA 서비스에서 이 파일을 만든 애플리케이션과 관련하여 파일의 외부 보기를 수정하지 않습니다. 프라이빗 데이터 스트림을 파일에 추가하는 데 사용할 수 있습니다.
USN_SOURCE_REPLICATION_MANAGEMENT 서비스에서 복제본 집합의 다른 멤버에 있는 동일한 파일의 내용과 일치하도록 파일을 수정하고 있습니다.
USN_SOURCE_CLIENT_REPLICATION_MANAGEMENT 클라우드 또는 서버에서 클라이언트 시스템에서 복제가 수행되고 있습니다. 이 값을 설정하려면 볼륨 핸들이 필요하지 않습니다.

VolumeHandle

이 작업에 대한 볼륨 핸들입니다.

HandleInfo

요청을 식별하는 플래그를 포함합니다. 이 필드는 다음 값 중 하나일 수 있습니다.

기 의미
MARK_HANDLE_PROTECT_CLUSTERS 핸들을 닫을 때까지 조각 모음(FSCTL_MOVE_FILE)을 허용하지 않습니다.
MARK_HANDLE_TXF_SYSTEM_LOG 이 스트림은 볼륨의 리소스 관리자에 대한 Txf 로그로 사용되고 있습니다. IRP_MN_KERNEL_CALL 사용하여 커널에서 호출해야 합니다. Windows Vista부터 사용할 수 있습니다.
MARK_HANDLE_NOT_TXF_SYSTEM_LOG 이 구성 요소는 더 이상 이 개체를 TxF 로그 파일로 사용하지 않습니다. Windows Vista부터 사용할 수 있습니다.
MARK_HANDLE_REALTIME UDFS 파일 시스템에서만 지원됩니다. 디바이스를 표시하여 비디오의 실시간 스트리밍을 수행합니다. Windows 7부터 사용할 수 있습니다.
MARK_HANDLE_NOT_REALTIME UDFS 파일 시스템에서만 지원됩니다. 디바이스가 더 이상 비디오의 실시간 스트리밍을 수행하지 않도록 표시합니다. Windows 7부터 사용할 수 있습니다.
MARK_HANDLE_CLOUD_SYNC 되지 않는; 이 플래그를 사용하지 마세요.
MARK_HANDLE_READ_COPY 지정된 데이터 복사본에서 데이터를 읽어야 합니다. 스토리지 공간 중복 볼륨에 대해서만 지원됩니다. Windows 8부터 사용할 수 있습니다.
MARK_HANDLE_NOT_READ_COPY 데이터는 더 이상 특정 복사본에서 읽을 수 없습니다. 스토리지 공간 중복 볼륨에 대해서만 지원됩니다. Windows 8부터 사용할 수 있습니다.
MARK_HANDLE_FILTER_METADATA 내부 Microsoft용으로만 예약됩니다.
MARK_HANDLE_RETURN_PURGE_FAILURE 메모리 매핑/캐시된 IO를 캐시되지 않은 IO와 혼합하고 캐시되지 않은 IO를 발급하는 경우 시스템은 캐시되지 않은 IO 범위에 대한 메모리 매핑을 제거하려고 시도합니다. 이러한 제거가 실패하는 경우 시스템은 일반적으로 손상된 상태로 이어질 수 있는 호출자에게 오류를 반환하지 않습니다. 이 플래그는 애플리케이션이 이 상황을 더 잘 처리할 수 있도록 지정된 핸들에 대한 제거 오류를 반환하도록 시스템에 지시합니다. Windows 8.1부터 사용할 수 있습니다.
MARK_HANDLE_DISABLE_FILE_METADATA_OPTIMIZATION 지정된 파일에서 FRS(파일 레코드 세그먼트) 압축 기능을 사용하지 않도록 설정합니다. Windows 10 버전 1507부터 사용할 수 있습니다.
MARK_HANDLE_ENABLE_USN_SOURCE_ON_PAGING_IO USN 저널의 페이징 쓰기에서 지정된 UsnSourceInfo 값을 설정하도록 NTFS에 지시합니다. 일반적으로 지정된 변경 내용을 수행한 스레드를 알지 못했기 때문에 쓰기 페이징에서 수행되지 않았습니다. 이는 재정의입니다. 이는 메모리 관리자가 보유하고 있는 FileObject에 이 상태가 연결된 경우에만 작동합니다. Windows 10 버전 1507부터 사용할 수 있습니다.
MARK_HANDLE_SKIP_COHERENCY_SYNC_DISALLOW_WRITES 이 파일에 쓰기가 허용되지 않는다는 것을 시스템에 알릴 수 있습니다. 다른 사용자가 쓰기 액세스를 위해 파일을 열려고 하면 STATUS_ACCESS_DENIED 작업이 실패합니다. 쓰기가 표시되면 작업이 STATUS_MARKED_TO_DISALLOW_WRITES 함께 실패합니다. Windows 10 버전 1507부터 사용할 수 있습니다.
MARK_HANDLE_ENABLE_CPU_CACHE 내부 Microsoft용으로만 예약됩니다.
MARK_HANDLE_SUPPRESS_VOLUME_OPEN_FLUSH 일반적으로 볼륨 핸들(DASD 열기)의 첫 번째 읽기/쓰기 작업에서 파일 시스템은 볼륨을 플러시합니다. 이는 특정 시나리오에서 성능에 영향을 미칠 수 있습니다. 이 플래그가 볼륨 핸들에 설정된 경우 첫 번째 IO에서 해당 플러시를 표시하지 않습니다. Windows 11부터 사용할 수 있습니다.

발언

MARK_HANDLE_INFO 지정된 파일 또는 디렉터리를 표시하는 데 사용되는 정보와 변경 내용에 대한 데이터를 사용하여 USN(업데이트 시퀀스 번호) 변경 저널 레코드를 포함합니다.

요구 사항

요구 값
지원되는 최소 클라이언트 Windows XP
헤더 ntifs.h

참고 항목

FSCTL_MARK_HANDLE