Funzione FsRtlFindExtraCreateParameter (ntifs.h)

Articolo
12/21/2024

La routine FsRtlFindExtraCreateParameter ricerca in un determinato elenco ECP una struttura di contesto ECP di un determinato tipo e restituisce un puntatore a questa struttura, se presente.

Sintassi

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

Parametri

[in] EcpList

Puntatore alla struttura di elenco ECP usata FsRtlFindExtraCreateParameter per cercare la struttura del contesto ECP, fornita dal parametro EcpType.

[in] EcpType

Puntatore a un GUID che identifica in modo univoco la struttura del contesto ECP. Questo valore GUID viene utilizzato dalla routine FsRtlFindExtraCreateParamter per determinare se la struttura del contesto ECP esiste nell'elenco ECP, fornita dal parametro EcpList.

[out, optional] EcpContext

Parametro facoltativo che riceve un puntatore alla struttura di contesto ECP trovata. Se la struttura del contesto ECP non viene trovata nell'elenco ECP, EcpContext è impostata su NULL. Se EcpContext è impostato su NULL dal chiamante, è possibile utilizzare il valore restituito di FsRtlFindExtraCreateParamter per determinare se la struttura del contesto ECP si trova nell'elenco ECP.

[out, optional] EcpContextSize

Parametro facoltativo che riceve le dimensioni, in byte, della struttura di contesto ECP trovata. Se la struttura del contesto ECP non viene trovata, EcpContextSize è impostata su zero.

Valore restituito

FsRtlFindExtraCreateParameter restituisce uno dei valori NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	FsRtlFindExtraCreateParameter trovato la struttura di contesto ECP specificata nell'elenco ECP specificato.
STATUS_NOT_FOUND	FsRtlFindExtraCreateParameter non ha trovato la struttura di contesto ECP specificata nell'elenco ECP specificato.

Fabbisogno

Requisito	Valore
client minimo supportato	La routine FsRtlFindExtraCreateParameter è disponibile a partire da Windows Vista.
piattaforma di destinazione	Universale
intestazione	ntifs.h (include Ntifs.h)
libreria	NtosKrnl.lib
dll	NtosKrnl.exe
IRQL	<= APC_LEVEL