Funzione FsRtlFindExtraCreateParameter (ntifs.h)

Articolo
02/29/2024

La routine FsRtlFindExtraCreateParameter cerca 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 dell'elenco ECP usata da 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 è impostato su NULL. Se EcpContext è impostato su NULL dal chiamante, il valore restituito di FsRtlFindExtraCreateParamter può essere utilizzato per determinare se la struttura di 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 è impostato su zero.

Valore restituito

FsRtlFindExtraCreateParameter restituisce uno dei valori NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	FsRtlFindExtraCreateParameter ha 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.

Requisiti

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