NDK_FN_CREATE_MR fonction de rappel (ndkpi.h)

Article
02/07/2025

La fonction NdkCreateMr (NDK_FN_CREATE_MR) crée un objet NDK memory region (MR).

Syntaxe

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

Paramètres

[in] pNdkPd

Pointeur vers un objet de domaine de protection NDK () (NDK_).

[in] FastRegister

Si la valeur est TRUE, MR est destiné uniquement à l’inscription rapide. Dans le cas contraire, mr est destiné à un registre normal uniquement.

[in] CreateCompletion

Pointeur vers une fonction NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) qui termine la création d’un objet NDK.

[in, optional] RequestContext

Valeur de contexte que le fournisseur NDK transmet à la fonction NdkCreateCompletion spécifiée dans le paramètre CreateCompletion.

ppNdkMr

Un pointeur vers l’objet MR créé (NDK_MR) est retourné à cet emplacement si la requête réussit sans retourner STATUS_PENDING. Si NdkCreateMr retourne STATUS_PENDING, ce paramètre est ignoré et l’objet créé est retourné avec le rappel spécifié dans le paramètre CreateCompletion.

Valeur de retour

La fonction NdkCreateMr retourne l’un des codes NTSTATUS suivants.

Retourner le code	Description
STATUS_SUCCESS	L’objet MR a été créé avec succès et retourné avec le paramètre *ppNdkMr.
STATUS_PENDING	L’opération est en attente et sera terminée ultérieurement. Le fournisseur appelle la fonction spécifiée dans la CreateCompletion paramètre(NDK_FN_CREATE_COMPLETION) pour terminer l’opération en attente.
STATUS_INSUFFICIENT_RESOURCES	La requête a échoué en raison de ressources insuffisantes. Important La requête peut échouer en ligne, ainsi que de manière asynchrone avec ce code d’état.
Autres codes d’état	Une erreur s’est produite.

Remarques

La fonction NdkCreateMr crée un objet mr (NDK memory region) qui peut être utilisé pour l’inscription de mémoire et les demandes d’inscription rapides. Si la fonction retourne STATUS_SUCCESS, l’objet créé est retourné dans le paramètre ppNdkMr. Si NdkCreateMr retourne STATUS_PENDING, l’objet créé est retourné par la fonction NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) spécifiée dans le paramètre CreateCompletion.

Exigences

Exigence	Valeur
client minimum pris en charge	Aucune prise en charge, prise en charge dans NDIS 6.30 et versions ultérieures.
serveur minimum pris en charge	Windows Server 2012
plateforme cible	Windows
d’en-tête	ndkpi.h (include Ndkpi.h)
IRQL	<=DISPATCH_LEVEL

Voir aussi

exigences de durée de vie des objets NDKPI

NDK_FN_CREATE_COMPLETION

NDK_MR

NDK_PD

Partager via