다음을 통해 공유

시스템 정의 ECP

  • 아티클

[!NOTE]

일부 정보는 상업용으로 출시되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적, 또는 묵시적인 보증을 하지 않습니다.

이 페이지에서는 시스템 정의 ECP(추가 만들기 매개 변수)를 나열하고 설명합니다. 운영 체제는 Ntifs.h 헤더 파일에서 이러한 ECP를 정의합니다.

이러한 시스템 정의 ECP는 지정된 추가 정보를 파일의 IRP_MJ_CREATE 작업에 연결합니다. 파일 시스템 스택의 요소는 추가 정보를 위해 ECP를 쿼리할 수 있습니다.

일반적으로 파일에서 IRP_MJ_CREATE 작업을 처리한 다음 아래 필터로 파일을 전달하는 필터는 시스템 정의 ECP 를 파일의 IRP_MJ_CREATE 작업에 연결하고 스푸핑해서는 안 됩니다.

마찬가지로 파일에 대한 IRP_MJ_CREATE 작업을 처리하고 발급하는 커널 모드 드라이버는 시스템 정의 ECP를 파일의 IRP_MJ_CREATE 작업에 연결하고 스푸핑해서는 안 됩니다.

필터 드라이버는 시스템 정의 ECP를 읽기 전용으로 간주해야 합니다. 정보를 검색하는 데만 사용해야 합니다.

필터 드라이버가 다음 시스템 정의 ECP 중 하나를 연결하지 못하도록 제한하는 한 가지 예외는 필터 드라이버가 계층화된 파일 시스템을 구현하는 경우입니다. 이 작업은 파일 개체를 소유하고 필터 드라이버가 자체 파일 개체에서 서비스하는 파일의 IRP_MJ_CREATE 작업에 대한 응답으로 해당 필터 아래의 파일에 대해 고유한 IRP_MJ_CREATE 작업을 실행하여 수행합니다. 이러한 필터 드라이버는 파일의 원래 IRP_MJ_CREATE 작업에서 필터 드라이버가 발급하는 IRP_MJ_CREATE 작업으로 ECP_LIST 컨텍스트 구조 목록을 전파해야 합니다. 이러한 ECP 목록을 전파하여 필터 드라이버는 IRP_MJ_CREATE 작업을 발급하는 필터 아래의 모든 필터가 원래 IRP_MJ_CREATE 작업의 컨텍스트를 인식하도록 합니다.

ECP GUID ECP 컨텍스트 구조 및 의미
ECP_TYPE_CLFS_CREATE_CONTAINER CREATE_REDIRECTION_ECP_CONTEXT ECP 컨텍스트 구조를 식별하는 데 사용되는 GUID입니다. 이 ECP는 볼륨 탑재 중에 새로운 CLFS(일반 로그 파일 시스템) 컨테이너를 삽입하기 위해 NTFS로 보낼 수 있습니다.
ECP_TYPE_IO_STOP_ON_SYMLINK_FILTER_GUID IO_STOP_ON_SYMLINK_FILTER_ECP_v0 ECP 컨텍스트 구조를 식별하는 GUID입니다. 이 ECP는 지정된 재구문 태그에 대해서만 작동하도록 IO_STOP_ON_SYMLINK 동작을 제한합니다.
ECP_TYPE_OPEN_REPARSE_GUID OPEN_REPARSE_LIST ECP 컨텍스트 구조를 식별하는 GUID입니다. 이 ECP는 재구매 지점의 모든 클래스에 대한 재구매 동작을 억제하지 않고 특정 재구매 지점을 여는 호출자를 지원합니다.
GUID_ECP_ATOMIC_CREATE ATOMIC_CREATE_ECP_CONTEXT ECP 컨텍스트 구조를 식별하는 GUID입니다. 이 ECP를 사용하면 만드는 동안 특정 추가 작업을 파일에서 원자성으로 수행할 수 있습니다.
GUID_ECP_CLOUDFILES_ATTRIBUTION 클라우드 파일 특성에 대한 ECP를 식별하는 GUID입니다.
GUID_ECP_CREATE_REDIRECTION 특정 만들기 작업에 대한 파일의 리디렉션 상태를 쿼리하기 위해 보낼 수 있는 ECP를 식별하는 데 사용되는 GUID입니다.
GUID_ECP_CSV_DOWN_LEVEL_OPEN CSV_DOWN_LEVEL_OPEN_ECP_CONTEXT ECP 컨텍스트 구조를 식별하는 GUID입니다. CSVFS(클러스터 공유 볼륨 파일 시스템)는 이 ECP를 MDS(메타데이터 노드)로 보내고 만들기 유형에 대한 정보를 포함합니다.
GUID_ECP_CSV_QUERY_FILE_REVISION CSV_QUERY_FILE_REVISION_ECP_CONTEXT ECP 컨텍스트 구조를 식별하는 GUID입니다. 이 ECP를 CSVFS로 보내 파일 수정 번호를 요청할 수 있습니다.
GUID_ECP_CSV_QUERY_FILE_REVISION_FILE_ID_128 CSV_QUERY_FILE_REVISION_ECP_CONTEXT_FILE_ID_128 ECP 컨텍스트 구조를 식별하는 GUID입니다. 이 ECP를 CSVFS로 보내 파일 수정 번호를 요청할 수 있습니다.
GUID_ECP_CSV_SET_HANDLE_PROPERTIES CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT ECP 컨텍스트 구조를 식별하는 GUID입니다. 이 ECP를 CSVFS로 전송하여 이 열기에 도착하는 IO를 처리하는 방법에 대한 속성을 설정할 수 있습니다.
GUID_ECP_DUAL_OPLOCK_KEY DUAL OPLOCK_KEY_ECP_CONTEXT ECP 컨텍스트 구조를 식별하는 GUID입니다. OPLOCK_KEY_ECP_CONTEXT 구조와 마찬가지로 DUAL OPLOCK_KEY_ECP_CONTEXT 사용하여 열려 있는 파일 요청에 oplock 키를 연결합니다. DUAL OPLOCK_KEY_ECP_CONTEXT 사용하여 대상 파일의 디렉터리에 대한 oplock을 제공하도록 부모 키를 설정할 수도 있습니다.
GUID_ECP_IO_DEVICE_HINT IO_DEVICE_HINT_ECP_CONTEXT 구조를 식별하는 GUID입니다. 디바이스 힌트는 이름 공급자 미니 필터 드라이버가 재설계 대상을 새 디바이스로 추적하는 데 사용됩니다.
GUID_ECP_NETWORK_APP_INSTANCE NETWORK_APP_INSTANCE_ECP_CONTEXT ECP 컨텍스트 구조를 식별하는 GUID입니다. 장애 조치(failover) 클러스터의 클라이언트 애플리케이션에는 클러스터의 노드에서 열린 파일 집합이 있을 수 있습니다. 파일 개체는 NETWORK_APP_INSTANCE_ECP_CONTEXT 구조의 인스턴스 식별자에 의해 애플리케이션에 태그가 지정됩니다. 장애 조치 시 보조 노드는 이전에 캐시된 애플리케이션 인스턴스 식별자를 사용하여 열린 파일에 대한 클라이언트 애플리케이션의 액세스 유효성을 검사할 수 있습니다.
GUID_ECP_NETWORK_APP_INSTANCE_VERSION 애플리케이션이 인스턴스 ID를 제공하는 ECP 컨텍스트인 NETWORK_APP_INSTANCE_VERSION_ECP_CONTEXT 구조를 식별하는 GUID입니다. 이 ECP는 유효한 NETWORK_APP_INSTANCE_ECP_CONTEXT (GUID_ECP_NETWORK_APP_INSTANCE)를 동반해야 합니다.
GUID_ECP_NETWORK_OPEN_CONTEXT NETWORK_OPEN_ECP_CONTEXT ECP 컨텍스트 구조를 식별하고 네트워크 리디렉션자에 대한 추가 정보를 연결하는 데 사용되는 GUID입니다. 또한 이 GUID는 Windows 7 이상 버전의 Windows에서 실행되고 Windows Vista에 있는 파일에서 네트워크 ECP 컨텍스트를 해석해야 하는 드라이버의 NETWORK_OPEN_ECP_CONTEXT_V0 구조를 식별합니다.
GUID_ECP_NFS_OPEN NFS_OPEN_ECP_CONTEXT 구조를 식별하는 GUID입니다. NFS(네트워크 파일 시스템) 서버는 NFS_OPEN_ECP_CONTEXT 구조를 열린 파일 요청에 연결합니다. NFS 서버는 NFS 서버가 클라이언트 요청을 충족하기 위해 만드는 열려 있는 파일 요청에서 이 GUID를 사용합니다. 그런 다음 파일 시스템 스택은 NFS_OPEN_ECP_CONTEXT 열린 파일 요청에 연결되어 있는지 여부를 확인할 수 있습니다. 파일 시스템 스택의 NFS_OPEN_ECP_CONTEXT 정보에 따라 파일을 열어 달라고 요청한 클라이언트와 그 이유를 확인할 수 있습니다.
GUID_ECP_OPEN_PARAMETERS ECP_OPEN_PARAMETERS ECP 컨텍스트 구조를 식별하는 GUID입니다. 이 ECP를 사용하면 호출자가 파일의 기존 핸들 및/또는 기회 잠금(oplock)을 방해하지 않고 열린 파일의 용도를 지정할 수 있습니다.
GUID_ECP_OPLOCK_KEY OPLOCK_KEY_ECP_CONTEXT ECP 컨텍스트 구조를 식별하고 열려 있는 파일 요청에 oplock 키를 연결하는 데 사용되는 GUID입니다. oplock 키를 사용하면 애플리케이션이 애플리케이션 자체 oplock을 중단하지 않고 동일한 스트림에 대한 여러 핸들을 열 수 있습니다. oplock 및 oplock 키에 대한 자세한 내용은 Oplock 의미 체계 개요를 참조 하세요.
GUID_ECP_PREFETCH_OPEN PREFETCH_OPEN_ECP_CONTEXT ECP 컨텍스트 구조를 식별하는 GUID입니다. 프리페처는 디스크 액세스 효율성을 높이고 성능을 향상시키기 위해 캐시 관리자 및 메모리 관리자와 긴밀하게 통합된 OS 구성 요소입니다. 다른 구성 요소가 프리페처를 방해하면 시스템 성능이 저하되고 교착 상태가 발생할 수 있습니다. 따라서 프리페처는 파일에 PREFETCH_OPEN_ECP_CONTEXT 구조를 연결하여 프리페처가 파일에 대해 열린 요청을 수행한다는 것을 전달합니다. 이 열린 요청은 PREFETCH_OPEN_ECP_CONTEXT Context 멤버에 의해 지정됩니다. 파일 시스템 필터 드라이버와 같은 다른 구성 요소는 PREFETCH_OPEN_ECP_CONTEXT 파일에 연결되어 있는지 여부를 확인한 다음 적절한 조치를 취할 수 있습니다.
GUID_ECP_QUERY_ON_CREATE 생성 시 쿼리 파일 정보에 대한 ECP를 식별하는 GUID입니다.
GUID_ECP_RKF_BYPASS RKF_BYPASS_ECP_CONTEXT ECP 컨텍스트 구조를 식별하는 GUID입니다.
GUID_ECP_SRV_OPEN SRV_OPEN_ECP_CONTEXT ECP 컨텍스트 구조를 식별하는 GUID입니다. 서버는 SRV_OPEN_ECP_CONTEXT 구조를 열린 파일 요청에 연결합니다. 서버는 서버가 조건부 클라이언트 요청을 충족하기 위해 만드는 열려 있는 파일 요청에서 이 GUID를 사용합니다. 그런 다음 파일 시스템 스택은 SRV_OPEN_ECP_CONTEXT 열린 파일 요청에 연결되어 있는지 여부를 확인할 수 있습니다. 파일 시스템 스택의 SRV_OPEN_ECP_CONTEXT 정보에 따라 파일을 열어 달라고 요청한 클라이언트와 그 이유를 확인할 수 있습니다. 서버에서 만든 모든 항목이 이 ECP를 수행하는 것은 아닙니다.
GUID_ECP_TYPE_VETO_BINDING VETO_BINDING_ECP_CONTEXT ECP 컨텍스트 구조를 식별합니다. 이 ECP는 시스템의 부팅 파티션에서 바인딩 링크를 거부하는 데 사용할 수 있습니다. Windows 11 버전 24H2부터 사용할 수 있습니다.