NDK_FN_INITIALIZE_FAST_REGISTER_MR funzione di callback (ndkpi.h)

  • Articolo

La funzione NdkInitializeFastRegisterMr (NDK_FN_INITIALIZE_FAST_REGISTER_MR) inizializza un'area di memoria NDK (MR) per la registrazione rapida.

Sintassi

NDK_FN_INITIALIZE_FAST_REGISTER_MR NdkFnInitializeFastRegisterMr;

NTSTATUS NdkFnInitializeFastRegisterMr(
  [in]           NDK_MR *pNdkMr,
  [in]           ULONG AdapterPageCount,
  [in]           BOOLEAN RemoteAccess,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

Parametri

[in] pNdkMr

Puntatore a un oggetto di memoria NDK (MR) (NDK_MR).

[in] AdapterPageCount

Numero massimo di pagine dell'adattatore da supportare in questo mr, in modo che sia possibile supportare richieste di lavoro con registrazione rapida con uguale o un numero inferiore di pagine dell'adattatore.

[in] RemoteAccess

Valore BOOLEAN che indica se l'istanza di MR deve essere inizializzata per l'accesso remoto o meno. Un consumer NDK deve impostare RemoteAccess su TRUE se il consumer richiederà l'accesso remoto con la funzione NdkFastRegister (NDK_FN_FAST_REGISTER).

[in] RequestCompletion

Puntatore a una routine di callback del completamento della richiesta NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION).

[in, optional] RequestContext

Valore di contesto da passare al parametro Context della funzione callback specificata nel parametro RequestCompletion .

Valore restituito

The
La funzione NdkInitializeFastRegisterMr restituisce uno dei codici NTSTATUS seguenti.

Codice restituito Descrizione
STATUS_SUCCESS
 L'inizializzazione è stata completata correttamente.
STATUS_PENDING
 L'operazione è in sospeso e verrà completata in un secondo momento. Il driver chiamerà la funzione RequestCompletion (NDK_FN_REQUEST_COMPLETION) specificata per completare l'operazione in sospeso.
STATUS_IMPLEMENTATION_LIMIT
 La richiesta non è riuscita perché l'adapter non supporta l'adapter AdapterPageCount richiesto.
Altri codici di stato
 Si è verificato un errore.

Commenti

NdkInitializeFastRegisterMr inizializza un mr per la registrazione rapida. L'oggetto NDK_MR deve essere creato con il parametro FastRegister della funzione NdkCreateMr (NDK_FN_CREATE_MR) impostata su TRUE.

È possibile effettuare più chiamate a NdkInitializeFastRegisterMr, in parallelo o uno dopo l'altro.

Dopo che NdkInitializeFastRegisterMr restituisce, una richiesta di lavoro di registrazione rapida può essere inviata a una coppia di code (QP).

Requisiti

Requisito Valore
Client minimo supportato Nessuna supportata, supportata in NDIS 6.30 e versioni successive.
Server minimo supportato Windows Server 2012
Piattaforma di destinazione Windows
Intestazione ndkpi.h (include Ndkpi.h)
IRQL <=DISPATCH_LEVEL

Vedi anche

Requisiti di durata dell'oggetto ND KPI

NDK_FN_CREATE_MR

NDK_FN_FAST_REGISTER

NDK_FN_REQUEST_COMPLETION

NDK_MR