FsRtlRemoveExtraCreateParameter 함수(ntifs.h)

아티클
12/21/2024

FsRtlRemoveExtraCreateParameter 루틴은 ECP 목록에서 ECP 컨텍스트 구조를 검색하고 있는 경우 ECP 목록에서 분리합니다.

통사론

NTSTATUS FsRtlRemoveExtraCreateParameter(
  [in, out]       PECP_LIST EcpList,
  [in]            LPCGUID   EcpType,
  [out]           PVOID     *EcpContext,
  [out, optional] ULONG     *EcpContextSize
);

매개 변수

[in, out] EcpList

지정된 목록에서 분리할 ECP 컨텍스트 구조를 포함하는 ECP(추가 만들기 매개 변수) 목록에 대한 포인터입니다.

[in] EcpType

목록에서 분리할 ECP 컨텍스트 구조를 고유하게 식별하는 GUID에 대한 포인터입니다.

[out] EcpContext

분리된 ECP 컨텍스트 구조에 대한 포인터입니다. ECP 컨텍스트 구조가 지정된 목록에서 성공적으로 분리된 경우 이 매개 변수는 분리된 ECP 컨텍스트 구조를 가리키도록 설정됩니다. 지정된 ECP 목록에서 ECP 컨텍스트 구조를 찾을 수 없는 경우 이 매개 변수는 NULL설정됩니다.

[out, optional] EcpContextSize

분리된 ECP 컨텍스트 구조의 크기를 받는 선택적 매개 변수입니다. 루틴이 호출될 때 이 매개 변수가 있는 경우 매개 변수는 분리된 ECP 컨텍스트 구조의 크기(바이트)를 받습니다. 지정된 ECP 컨텍스트 구조를 지정된 ECP 목록에서 찾을 수 없는 경우 이 매개 변수는 정의되지 않습니다.

반환 값

FsRtlRemoveExtraCreateParameter 다음 중 하나와 같은 NTSTATUS 코드를 반환합니다.

반환 코드	묘사
STATUS_SUCCESS	지정된 ECP 컨텍스트 구조가 지정된 ECP 목록에서 성공적으로 분리되었습니다.
STATUS_NOT_FOUND	지정된 ECP 컨텍스트 구조가 지정된 ECP 목록에서 찾을 수 없습니다.

발언

FsRtlRemoveExtraCreateParameter 루틴은 EcpList 매개 변수에서 제공한 ECP 목록에서 EcpType 매개 변수에서 제공하는 ECP 컨텍스트 구조를 검색합니다. ECP 컨텍스트 구조가 목록에 있는 경우 FsRtlRemoveExtraCreateParameter 목록에서 구조를 분리하고, 구조체를 가리키도록 EcpContext 매개 변수를 설정하고, STATUS_SUCCESS 반환합니다. ECP 컨텍스트 구조가 목록에 없으면 FsRtlRemoveExtraCreateParameterEcpContext 매개 변수를 NULL 설정하고 STATUS_NOT_FOUND 반환합니다.

메모

FsRtlRemoveExtraCreateParameter ECP 컨텍스트 구조에 대한 메모리 풀을 해제하지 않습니다. ECP 컨텍스트 구조에 대한 메모리 풀을 해제하려면 먼저 FsRtlRemoveExtraCreateParameter 호출하여 목록에서 분리한 다음 FltFreeExtraCreateParameter 루틴을 호출하여 ECP 컨텍스트 구조에 대한 메모리 풀을 해제합니다.

요구 사항

요구	값
지원되는 최소 클라이언트	FsRtlRemoveExtraCreateParameter 루틴은 Windows Vista부터 사용할 수 있습니다.
대상 플랫폼	보편적
헤더	ntifs.h(Ntifs.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL