NDK_FN_CREATE_COMPLETION fonction de rappel (ndkpi.h)

Article
02/27/2024

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 au contexte le pointeur de la fonction de fin de création asynchrone NdkCreateCompletion (NDK_FN_CREATE_COMPLETION).

[in] Status

La status d’achèvement asynchrone pour la demande de création. Consultez les fonctions de création d’objets (par exemple, NDK_FN_CREATE_CQ) pour connaître l’achèvement status codes 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

None

Remarques

Note 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 create completion pour indiquer que la création de l’objet est terminée.

Tout status autre code status 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 create request retourne un code NT_STATUS status autre que STATUS_PENDING, l’objet créé doit être retourné dans un paramètre de sortie avec la fonction create request.

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

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