Fonction FsRtlFindExtraCreateParameter (ntifs.h)

Article
02/29/2024

La routine FsRtlFindExtraCreateParameter recherche dans une liste ECP donnée une structure de contexte ECP d’un type donné et retourne un pointeur vers cette structure si elle est trouvée.

Syntaxe

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

Paramètres

[in] EcpList

Pointeur vers la structure de liste ECP que FsRtlFindExtraCreateParameter utilise pour rechercher la structure de contexte ECP, fournie par le paramètre EcpType .

[in] EcpType

Pointeur vers un GUID qui identifie de manière unique la structure de contexte ECP. Cette valeur GUID est utilisée par la routine FsRtlFindExtraCreateParamter pour déterminer si la structure de contexte ECP existe dans la liste ECP, fournie par le paramètre EcpList .

[out, optional] EcpContext

Paramètre facultatif qui reçoit un pointeur vers la structure de contexte ECP trouvée. Si la structure de contexte ECP est introuvable dans la liste ECP, EcpContext est défini sur NULL. Si EcpContext est défini sur NULL par l’appelant, la valeur de retour de FsRtlFindExtraCreateParamter peut être utilisée pour déterminer si la structure de contexte ECP figure dans la liste ECP.

[out, optional] EcpContextSize

Paramètre facultatif qui reçoit la taille, en octets, de la structure de contexte ECP trouvée. Si la structure de contexte ECP est introuvable, EcpContextSize est défini sur zéro.

Valeur retournée

FsRtlFindExtraCreateParameter retourne l’une des valeurs NTSTATUS suivantes :

Code de retour	Description
STATUS_SUCCESS	FsRtlFindExtraCreateParameter a trouvé la structure de contexte ECP spécifiée dans la liste ECP spécifiée.
STATUS_NOT_FOUND	FsRtlFindExtraCreateParameter n’a pas trouvé la structure de contexte ECP spécifiée dans la liste ECP spécifiée.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	La routine FsRtlFindExtraCreateParameter est disponible à partir de Windows Vista.
Plateforme cible	Universal
En-tête	ntifs.h (include Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL