NDK_FN_CREATE_MR funzione di callback (ndkpi.h)

Articolo
02/07/2025

La funzione NdkCreateMr (NDK_FN_CREATE_MR) crea un oggetto area di memoria NDK (MR).

Sintassi

NDK_FN_CREATE_MR NdkFnCreateMr;

NTSTATUS NdkFnCreateMr(
  [in]           NDK_PD *pNdkPd,
  [in]           BOOLEAN FastRegister,
  [in]           NDK_FN_CREATE_COMPLETION CreateCompletion,
  [in, optional] PVOID RequestContext,
                 NDK_MR **ppNdkMr
)
{...}

Parametri

[in] pNdkPd

Puntatore a un oggetto PD (NDK Protection Domain) (NDK_PD).

[in] FastRegister

Se TRUE, MR è solo per il registro rapido. In caso contrario, MR è solo per il registro normale.

[in] CreateCompletion

Puntatore a una funzione NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) che completa la creazione di un oggetto NDK.

[in, optional] RequestContext

Valore di contesto restituito dal provider NDK alla funzione NdkCreateCompletion specificata nel parametro CreateCompletion.

ppNdkMr

Un puntatore all'oggetto MR creato (NDK_MR) viene restituito in questa posizione se la richiesta ha esito positivo senza restituire STATUS_PENDING. Se NdkCreateMr restituisce STATUS_PENDING, questo parametro viene ignorato e l'oggetto creato viene restituito con il callback specificato nel parametro CreateCompletion.

Valore restituito

La funzione NdkCreateMr restituisce uno dei codici NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	L'oggetto MR è stato creato correttamente e restituito con il parametro *ppNdkMr.
STATUS_PENDING	L'operazione è in sospeso e verrà completata in un secondo momento. Il provider chiamerà la funzione specificata nella CreateCompletion parametro(NDK_FN_CREATE_COMPLETION) per completare l'operazione in sospeso.
STATUS_INSUFFICIENT_RESOURCES	La richiesta non è riuscita a causa di risorse insufficienti. Importante La richiesta può non riuscire inline e in modo asincrono con questo codice di stato.
Altri codici di stato	Si è verificato un errore.

Osservazioni

La funzione NdkCreateMr crea un oggetto area di memoria NDK (MR) che può essere usato per la registrazione della memoria e le richieste di registrazione rapida. Se la funzione restituisce STATUS_SUCCESS, l'oggetto creato viene restituito nel parametro ppNdkMr. Se NdkCreateMr restituisce STATUS_PENDING, l'oggetto creato viene restituito dalla funzione NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) specificata nel parametro CreateCompletion.

Fabbisogno

Requisito	Valore
client minimo supportato	Nessuna supportata, supportata in NDIS 6.30 e versioni successive.
server minimo supportato	Windows Server 2012
piattaforma di destinazione	Finestre
intestazione	ndkpi.h (include Ndkpi.h)
IRQL	<=DISPATCH_LEVEL

Vedere anche

requisiti di durata dell'oggetto NDKPI

NDK_FN_CREATE_COMPLETION

NDK_MR

NDK_PD

Condividi tramite