FsRtlFindExtraCreateParameter, fonction (ntifs.h)

Article
12/20/2024

Le FsRtlFindExtraCreateParameter routine recherche une liste ECP donnée pour 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 qui 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éfinie 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 se trouve 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 a la valeur zéro.

Valeur de retour

FsRtlFindExtraCreateParameter retourne l’une des valeurs NTSTATUS suivantes :

Retourner le code	Description
STATUS_SUCCESS	FsRtlFindExtraCreateParameter 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.

Exigences

Exigence	Valeur
client minimum pris en charge	La routine FsRtlFindExtraCreateParameter est disponible à partir de Windows Vista.
plateforme cible	Universel
d’en-tête	ntifs.h (include Ntifs.h)
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL