NDK_FN_CREATE_COMPLETION fonction de rappel (ndkpi.h)

Article
02/07/2025

La fonction NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) termine la création d’un objet NDK.

Syntaxe

NDK_FN_CREATE_COMPLETION NdkFnCreateCompletion;

void NdkFnCreateCompletion(
  [in, optional] PVOID Context,
  [in]           NTSTATUS Status,
  [in]           NDK_OBJECT_HEADER *pNdkObject
)
{...}

Paramètres

[in, optional] Context

Valeur de contexte transmise au fournisseur NDK lorsqu’un consommateur appelle une fonction de création d’objet. La fonction de création fournit le contexte avec la demande d’achèvement de création asynchrone pointeur de fonction NdkCreateCompletion (NDK_FN_CREATE_COMPLETION).

[in] Status

État d’achèvement asynchrone de la demande de création. Consultez les fonctions de création d’objets (par exemple, NDK_FN_CREATE_CQ) pour connaître les codes d’état d’achèvement qui peuvent être retournés pour chaque type d’objet.

[in] pNdkObject

Pointeur vers un en-tête d’objet NDK (NDK_OBJECT_HEADER).

Valeur de retour

Aucun

Remarques

Remarque Cette fonction est implémentée par le consommateur NDK et transmise au fournisseur NDK.

Les objets NDK sont créés avec des fonctions asynchrones. Ces fonctions de création d’objets asynchrones prennent un pointeur de fonction NDK_FN_CREATE_COMPLETION comme paramètre d’entrée.

Un fournisseur NDK peut retourner STATUS_PENDING à partir d’une fonction de création d’objet asynchrone. Dans ce cas, le fournisseur NDK doit appeler la fonction d’achèvement de création pour indiquer que la création de l’objet est terminée.

Tout autre code d’état indique l’achèvement inline. Dans ce cas, le fournisseur ne doit pas appeler la fonction d’achèvement de la demande de création. Si la fonction de demande de création retourne un code d’état NT_STATUS autre que STATUS_PENDING, l’objet créé doit être retourné dans un paramètre de sortie avec la fonction de demande de création.

Pour les demandes de création qui retournent STATUS_PENDING et les versions ultérieures avec STATUS_SUCCESS de manière asynchrone, l’objet créé doit être retourné par la fonction d’achèvement de création avec le paramètre pNdkObject et le fournisseur ne doit pas accéder au paramètre de sortie d’objet de la fonction de demande de création.

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