NDK_FN_CLOSE_OBJECT fonction de rappel (ndkpi.h)
La fonction NdkCloseObject (NDK_FN_CLOSE_OBJECT) lance une demande de fermeture pour un objet NDK.
Syntaxe
NDK_FN_CLOSE_OBJECT NdkFnCloseObject;
NTSTATUS NdkFnCloseObject(
[in] NDK_OBJECT_HEADER *pNdkObject,
[in] NDK_FN_CLOSE_COMPLETION CloseCompletion,
[in, optional] PVOID RequestContext
)
{...}
Paramètres
[in] pNdkObject
Pointeur vers l’en-tête d’objet (NDK_OBJECT_HEADER) pour que l’objet se ferme.
[in] CloseCompletion
Pointeur vers un NdkCloseCompletion fonction de rappel d’achèvement de fermeture (NDK_FN_CLOSE_COMPLETION).
[in, optional] RequestContext
Valeur de contexte pour le fournisseur NDK à transmettre à la fonction NdkCloseCompletion spécifiée dans le paramètre CloseCompletion.
Valeur de retour
La fonction NdkCloseObject retourne l’un des codes NTSTATUS suivants.
| Retourner le code | Description |
|---|---|
|
L’objet NDK est fermé. Le fournisseur n’appelle pas la fonction NdkCloseCompletion. |
|
La requête est en attente, le fournisseur appelle la fonction NdkCloseCompletion pour terminer l’opération de manière asynchrone. La demande de fermeture a été lancée avec succès, mais elle n’est peut-être pas terminée. |
|
Une erreur s’est produite. |
Remarques
La table de répartition des fonctions pour chaque type d’objet NDK inclut un pointeur de fonction NDK_FN_CLOSE_OBJECT. Les demandes de fermeture sont asynchrones. Un consommateur NDK ne doit pas accéder à l’objet après le démarrage d’une demande de fermeture.
Le fournisseur NDK doit s’assurer que la fonction NdkCloseCompletion (NDK_FN_CLOSE_COMPLETION) est le dernier rappel appelé pour l’objet fermant. Le fournisseur doit s’assurer que toutes les demandes asynchrones en attente sont terminées et que tous les rappels en cours ont retourné et que d’autres rappels sont empêchés avant que le fournisseur appelle la fonction NdkCloseCompletion. Une fois que le fournisseur appelle la fonction NdkCloseCompletion, le fournisseur n’appelle pas de fonctions d’achèvement ou de rappel de notification pour l’objet.
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 |