FsRtlFindExtraCreateParameter 함수(ntifs.h)

아티클
02/06/2022
읽는 데 2분 걸림

FsRtlFindExtraCreateParameter 루틴은 지정된 ECP 목록에서 지정된 형식의 ECP 컨텍스트 구조를 검색하고 발견되면 이 구조체에 대한 포인터를 반환합니다.

구문

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

매개 변수

[in] EcpList

FsRtlFindExtraCreateParameter가 EcpType 매개 변수에서 제공하는 ECP 컨텍스트 구조를 검색하는 데 사용하는 ECP 목록 구조에 대한 포인터입니다.

[in] EcpType

ECP 컨텍스트 구조를 고유하게 식별하는 GUID에 대한 포인터입니다. 이 GUID 값은 EcpList 매개 변수에서 제공하는 ECP 컨텍스트 구조가 ECP 목록에 있는지 확인하기 위해 FsRtlFindExtraCreateParamter 루틴에서 사용됩니다.

[out, optional] EcpContext

찾은 ECP 컨텍스트 구조에 대한 포인터를 수신하는 선택적 매개 변수입니다. ECP 목록에서 ECP 컨텍스트 구조를 찾을 수 없는 경우 EcpContext 는 NULL로 설정됩니다. EcpContext가 호출자에 의해 NULL로 설정된 경우 FsRtlFindExtraCreateParamter의 반환 값을 사용하여 ECP 컨텍스트 구조가 ECP 목록에 있는지 확인할 수 있습니다.

[out, optional] EcpContextSize

찾은 ECP 컨텍스트 구조의 크기(바이트)를 받는 선택적 매개 변수입니다. ECP 컨텍스트 구조를 찾을 수 없는 경우 EcpContextSize 는 0으로 설정됩니다.

반환 값

FsRtlFindExtraCreateParameter 는 다음 NTSTATUS 값 중 하나를 반환합니다.

반환 코드	설명
STATUS_SUCCESS	FsRtlFindExtraCreateParameter 는 지정된 ECP 목록에서 지정된 ECP 컨텍스트 구조를 찾았습니다.
STATUS_NOT_FOUND	FsRtlFindExtraCreateParameter 가 지정된 ECP 목록에서 지정된 ECP 컨텍스트 구조를 찾지 못했습니다.

요구 사항


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