[!NOTE]
일부 정보는 상업용으로 출시되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적, 또는 묵시적인 보증을 하지 않습니다.
이 페이지에서는 시스템 정의 ECP(추가 만들기 매개 변수)를 나열하고 설명합니다. The operating system defines these ECPs in the Ntifs.h header file.
These system-defined ECPs attach the specified extra information to the IRP_MJ_CREATE operation on a file. 파일 시스템 스택의 요소는 추가 정보를 위해 ECP를 쿼리할 수 있습니다.
Typically, a filter that processes the IRP_MJ_CREATE operation on a file and then passes the file down to filters below it must not attach and spoof any of the system-defined ECPs to the IRP_MJ_CREATE operation on the file.
Similarly, a kernel-mode driver that processes and issues IRP_MJ_CREATE operations on files must not attach and spoof any system-defined ECPs to the IRP_MJ_CREATE operations on the files.
필터 드라이버는 시스템 정의 ECP를 읽기 전용으로 간주해야 합니다. 정보를 검색하는 데만 사용해야 합니다.
필터 드라이버가 다음 시스템 정의 ECP 중 하나를 연결하지 못하도록 제한하는 한 가지 예외는 필터 드라이버가 계층화된 파일 시스템을 구현하는 경우입니다. It does this by owning file objects and by issuing its own IRP_MJ_CREATE operations on files below its filter, in response to the IRP_MJ_CREATE operation on a file that the filter driver services on its own file objects. Such a filter driver should propagate any ECP_LIST context structure lists from the original IRP_MJ_CREATE operation on a file to the IRP_MJ_CREATE operations that the filter driver issues below it. By propagating these ECP lists, the filter driver ensures that any filters below the filter that issues the IRP_MJ_CREATE operations are aware of the context of the original IRP_MJ_CREATE operation.
| ECP GUID | ECP 컨텍스트 구조 및 의미 |
|---|---|
| ECP_TYPE_CLFS_CREATE_CONTAINER | The GUID used to identify the CREATE_REDIRECTION_ECP_CONTEXT ECP context structure. 이 ECP는 볼륨 탑재 중에 새로운 CLFS(일반 로그 파일 시스템) 컨테이너를 삽입하기 위해 NTFS로 보낼 수 있습니다. |
| ECP_TYPE_IO_STOP_ON_SYMLINK_FILTER_GUID | The GUID that identifies the IO_STOP_ON_SYMLINK_FILTER_ECP_v0 ECP context structure. 이 ECP는 지정된 재구문 태그에 대해서만 작동하도록 IO_STOP_ON_SYMLINK 동작을 제한합니다. |
| ECP_TYPE_OPEN_REPARSE_GUID | The GUID that identifies the OPEN_REPARSE_LIST ECP context structure. 이 ECP는 재구매 지점의 모든 클래스에 대한 재구매 동작을 억제하지 않고 특정 재구매 지점을 여는 호출자를 지원합니다. |
| GUID_ECP_ATOMIC_CREATE | The GUID that identifies the ATOMIC_CREATE_ECP_CONTEXT ECP context structure. 이 ECP를 사용하면 만드는 동안 특정 추가 작업을 파일에서 원자성으로 수행할 수 있습니다. |
| GUID_ECP_CLOUDFILES_ATTRIBUTION | 클라우드 파일 특성에 대한 ECP를 식별하는 GUID입니다. |
| GUID_ECP_CREATE_REDIRECTION | 특정 만들기 작업에 대한 파일의 리디렉션 상태를 쿼리하기 위해 보낼 수 있는 ECP를 식별하는 데 사용되는 GUID입니다. |
| GUID_ECP_CSV_DOWN_LEVEL_OPEN | The GUID that identifies the CSV_DOWN_LEVEL_OPEN_ECP_CONTEXT ECP context structure. CSVFS(클러스터 공유 볼륨 파일 시스템)는 이 ECP를 MDS(메타데이터 노드)로 보내고 만들기 유형에 대한 정보를 포함합니다. |
| GUID_ECP_CSV_QUERY_FILE_REVISION | The GUID that identifies the CSV_QUERY_FILE_REVISION_ECP_CONTEXT ECP context structure. 이 ECP를 CSVFS로 보내 파일 수정 번호를 요청할 수 있습니다. |
| GUID_ECP_CSV_QUERY_FILE_REVISION_FILE_ID_128 | The GUID that identifies the CSV_QUERY_FILE_REVISION_ECP_CONTEXT_FILE_ID_128 ECP context structure. 이 ECP를 CSVFS로 보내 파일 수정 번호를 요청할 수 있습니다. |
| GUID_ECP_CSV_SET_HANDLE_PROPERTIES | The GUID that identifies the CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT ECP context structure. 이 ECP를 CSVFS로 전송하여 이 열기에 도착하는 IO를 처리하는 방법에 대한 속성을 설정할 수 있습니다. |
| GUID_ECP_DUAL_OPLOCK_KEY | The GUID that identifies the DUAL OPLOCK_KEY_ECP_CONTEXT ECP context structure. Like the OPLOCK_KEY_ECP_CONTEXT structure, DUAL OPLOCK_KEY_ECP_CONTEXT is used to attach an oplock key to the open file request. With DUAL OPLOCK_KEY_ECP_CONTEXT, a parent key can also be set to provide an oplock for a target file's directory. |
| GUID_ECP_IO_DEVICE_HINT | A GUID that identifies the IO_DEVICE_HINT_ECP_CONTEXT structure. 디바이스 힌트는 이름 공급자 미니 필터 드라이버가 재설계 대상을 새 디바이스로 추적하는 데 사용됩니다. |
| GUID_ECP_NETWORK_APP_INSTANCE | The GUID that identifies the NETWORK_APP_INSTANCE_ECP_CONTEXT ECP context structure. 장애 조치(failover) 클러스터의 클라이언트 애플리케이션에는 클러스터의 노드에서 열린 파일 집합이 있을 수 있습니다. The file objects are tagged to an application by an instance identifier in the NETWORK_APP_INSTANCE_ECP_CONTEXT structure. 장애 조치 시 보조 노드는 이전에 캐시된 애플리케이션 인스턴스 식별자를 사용하여 열린 파일에 대한 클라이언트 애플리케이션의 액세스 유효성을 검사할 수 있습니다. |
| GUID_ECP_NETWORK_APP_INSTANCE_VERSION | The GUID that identifies the NETWORK_APP_INSTANCE_VERSION_ECP_CONTEXT structure, which is an ECP context for an application to provide its instance ID. This ECP must accompany a NETWORK_APP_INSTANCE_ECP_CONTEXT (GUID_ECP_NETWORK_APP_INSTANCE) to be valid. |
| GUID_ECP_NETWORK_OPEN_CONTEXT | The GUID that identifies the NETWORK_OPEN_ECP_CONTEXT ECP context structure and is used to attach extra information for network redirectors. This GUID also identifies the NETWORK_OPEN_ECP_CONTEXT_V0 structure for drivers that run on Windows 7 and later versions of Windows and that must interpret network ECP contexts on files that reside on Windows Vista. |
| GUID_ECP_NFS_OPEN | The GUID that identifies the NFS_OPEN_ECP_CONTEXT structure. NFS(네트워크 파일 시스템) 서버는 NFS_OPEN_ECP_CONTEXT 구조를 열린 파일 요청에 연결합니다. NFS 서버는 NFS 서버가 클라이언트 요청을 충족하기 위해 만드는 열려 있는 파일 요청에서 이 GUID를 사용합니다. 그런 다음 파일 시스템 스택은 NFS_OPEN_ECP_CONTEXT 열린 파일 요청에 연결되어 있는지 여부를 확인할 수 있습니다. 파일 시스템 스택의 NFS_OPEN_ECP_CONTEXT 정보에 따라 파일을 열어 달라고 요청한 클라이언트와 그 이유를 확인할 수 있습니다. |
| GUID_ECP_OPEN_PARAMETERS | The GUID that identifies the ECP_OPEN_PARAMETERS ECP context structure. 이 ECP를 사용하면 호출자가 파일의 기존 핸들 및/또는 기회 잠금(oplock)을 방해하지 않고 열린 파일의 용도를 지정할 수 있습니다. |
| GUID_ECP_OPLOCK_KEY | The GUID that identifies the OPLOCK_KEY_ECP_CONTEXT ECP context structure and is used to attach an oplock key to the open file request. oplock 키를 사용하면 애플리케이션이 애플리케이션 자체 oplock을 중단하지 않고 동일한 스트림에 대한 여러 핸들을 열 수 있습니다. oplock 및 oplock 키에 대한 자세한 내용은 Oplock 의미 체계 개요를 참조 하세요. |
| GUID_ECP_PREFETCH_OPEN | The GUID that identifies the PREFETCH_OPEN_ECP_CONTEXT ECP context structure. 프리페처는 디스크 액세스 효율성을 높이고 성능을 향상시키기 위해 캐시 관리자 및 메모리 관리자와 긴밀하게 통합된 OS 구성 요소입니다. 다른 구성 요소가 프리페처를 방해하면 시스템 성능이 저하되고 교착 상태가 발생할 수 있습니다. 따라서 프리페처는 파일에 PREFETCH_OPEN_ECP_CONTEXT 구조를 연결하여 프리페처가 파일에 대해 열린 요청을 수행한다는 것을 전달합니다. This open request is specified by the Context member of PREFETCH_OPEN_ECP_CONTEXT. 파일 시스템 필터 드라이버와 같은 다른 구성 요소는 PREFETCH_OPEN_ECP_CONTEXT 파일에 연결되어 있는지 여부를 확인한 다음 적절한 조치를 취할 수 있습니다. |
| GUID_ECP_QUERY_ON_CREATE | 생성 시 쿼리 파일 정보에 대한 ECP를 식별하는 GUID입니다. |
| GUID_ECP_RKF_BYPASS | The GUID that identifies the RKF_BYPASS_ECP_CONTEXT ECP context structure. |
| GUID_ECP_SRV_OPEN | The GUID that identifies the SRV_OPEN_ECP_CONTEXT ECP context structure. 서버는 SRV_OPEN_ECP_CONTEXT 구조를 열린 파일 요청에 연결합니다. 서버는 서버가 조건부 클라이언트 요청을 충족하기 위해 만드는 열려 있는 파일 요청에서 이 GUID를 사용합니다. 그런 다음 파일 시스템 스택은 SRV_OPEN_ECP_CONTEXT 열린 파일 요청에 연결되어 있는지 여부를 확인할 수 있습니다. 파일 시스템 스택의 SRV_OPEN_ECP_CONTEXT 정보에 따라 파일을 열어 달라고 요청한 클라이언트와 그 이유를 확인할 수 있습니다. 서버에서 만든 모든 항목이 이 ECP를 수행하는 것은 아닙니다. |
| GUID_ECP_TYPE_VETO_BINDING | Identifies the VETO_BINDING_ECP_CONTEXT ECP context structure. 이 ECP는 시스템의 부팅 파티션에서 바인딩 링크를 거부하는 데 사용할 수 있습니다. Windows 11 버전 24H2부터 사용할 수 있습니다. |