FsRtlFindExtraCreateParameter 함수(ntifs.h)

아티클
12/21/2024

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 값은 FsRtlFindExtraCreateParamter 루틴에서 EcpList 매개 변수에서 제공하는 ECP 컨텍스트 구조가 ECP 목록에 있는지 확인하는 데 사용됩니다.

[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