NDK_FN_INITIALIZE_FAST_REGISTER_MR fonction de rappel (ndkpi.h)

  • Article

La fonction NdkInitializeFastRegisterMr (NDK_FN_INITIALIZE_FAST_REGISTER_MR) initialise une région de mémoire NDK (MR) pour une inscription rapide.

Syntaxe

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
)
{...}

Paramètres

[in] pNdkMr

Pointeur vers un objet de région de mémoire (MR) NDK (NDK_MR).

[in] AdapterPageCount

Nombre maximal de pages d’adaptateurs à prendre en charge dans cette MR, de sorte que les demandes de travail d’inscription rapide avec un nombre égal ou inférieur de pages d’adaptateur peuvent être prises en charge.

[in] RemoteAccess

Valeur BOOLEAN qui indique si la MR doit être initialisée ou non pour l’accès à distance. Un consommateur NDK doit définir RemoteAccess sur TRUE si le consommateur demande l’accès à distance avec la fonction NdkFastRegister (NDK_FN_FAST_REGISTER).

[in] RequestCompletion

Pointeur vers une routine de rappel de fin de requête NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION).

[in, optional] RequestContext

Valeur de contexte à passer au paramètre Context de la fonction de rappel spécifiée dans le paramètre RequestCompletion .

Valeur retournée

The
La fonction NdkInitializeFastRegisterMr retourne l’un des codes NTSTATUS suivants.

Code de retour Description
STATUS_SUCCESS
 L’initialisation a été effectuée avec succès.
STATUS_PENDING
 L’opération est en attente et sera terminée ultérieurement. Le pilote appelle la fonction RequestCompletion (NDK_FN_REQUEST_COMPLETION) spécifiée pour terminer l’opération en attente.
STATUS_IMPLEMENTATION_LIMIT
 La demande a échoué, car l’adaptateur ne prend pas en charge l’adaptateur AdapterPageCount demandé.
Autres codes status
 Une erreur est survenue.

Remarques

NdkInitializeFastRegisterMr initialise une mr pour une inscription rapide. L’objet NDK_MR doit être créé avec le paramètre FastRegister de la fonction NdkCreateMr (NDK_FN_CREATE_MR) définie sur TRUE.

Vous pouvez effectuer plusieurs appels à NdkInitializeFastRegisterMr, soit en parallèle, soit l’un après l’autre.

Après le retour de NdkInitializeFastRegisterMr , une demande de travail d’inscription rapide peut être publiée dans une paire de files d’attente (QP).

Configuration requise

Condition requise Valeur
Client minimal pris en charge Aucune prise en charge, prise en charge dans NDIS 6.30 et versions ultérieures.
Serveur minimal pris en charge Windows Server 2012
Plateforme cible Windows
En-tête ndkpi.h (incluez Ndkpi.h)
IRQL <=DISPATCH_LEVEL

Voir aussi

Exigences relatives à la durée de vie des objets NDKPI

NDK_FN_CREATE_MR

NDK_FN_FAST_REGISTER

NDK_FN_REQUEST_COMPLETION

NDK_MR