NDK_FN_CREATE_MR fonction de rappel (ndkpi.h)
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 (PD) NDK (NDK_PD).
[in] FastRegister
Si la valeur est TRUE, mr est uniquement pour l’inscription rapide. Dans le cas contraire, la MR est réservée au registre normal.
[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 demande 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 retournée
La fonction NdkCreateMr retourne l’un des codes NTSTATUS suivants.
Code de retour | Description |
---|---|
|
L’objet MR a été créé avec succès et retourné avec le paramètre *ppNdkMr . |
|
L’opération est en attente et sera terminée ultérieurement. Le fournisseur appelle la fonction spécifiée dans le paramètre CreateCompletion (NDK_FN_CREATE_COMPLETION) pour terminer l’opération en attente. |
|
La demande a échoué en raison de ressources insuffisantes.
Important La demande peut échouer en ligne et de manière asynchrone avec ce code status.
|
|
Une erreur est survenue. |
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 rapide. 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 .
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Aucun pris en charge, pris 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 (inclure Ndkpi.h) |
IRQL | <=DISPATCH_LEVEL |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : tout au long de 2024, nous allons éliminer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d'informations, consultez :Envoyer et afficher des commentaires pour