NPI_PROVIDER_CLEANUP_BINDING_CONTEXT_FN fonction de rappel (netioddk.h)
La fonction de rappel ProviderCleanupBindingContext d’un module fournisseur effectue tout nettoyage et désallocation nécessaires du contexte de liaison du module fournisseur une fois que le module fournisseur et un module client se sont détachés l’un de l’autre.
Syntaxe
NPI_PROVIDER_CLEANUP_BINDING_CONTEXT_FN NpiProviderCleanupBindingContextFn;
void NpiProviderCleanupBindingContextFn(
[in] PVOID ProviderBindingContext
)
{...}
Paramètres
[in] ProviderBindingContext
Pointeur vers le contexte du module fournisseur pour la liaison entre le module fournisseur et le module client duquel il s’est détaché. La fonction de rappel ProviderAttachClient du module fournisseur retourne ce pointeur vers la NMR lorsqu’elle s’attache au module client.
Valeur de retour
None
Remarques
La NMR appelle la fonction de rappel ProviderCleanupBindingContext d’un module fournisseur après que le fournisseur et un module client se sont détachés l’un de l’autre.
La fonction de rappel ProviderCleanupBindingContext d’un module fournisseur doit effectuer tout nettoyage nécessaire des données contenues dans la structure de contexte de liaison du module fournisseur. Il doit ensuite libérer la mémoire de la structure de contexte de liaison si le module fournisseur a alloué dynamiquement la mémoire pour la structure.
Si le module fournisseur n’alloue pas dynamiquement la mémoire pour son contexte de liaison et qu’aucun autre nettoyage de son contexte de liaison n’est nécessaire, le module fournisseur n’a pas besoin d’implémenter une fonction de rappel ProviderCleanupBindingContext . Si le module fournisseur n’implémente pas de fonction de rappel ProviderCleanupBindingContext , il doit définir le membre ProviderCleanupBindingContext du NPI_PROVIDER_CHARACTERISTICS structure à NULL quand elle appelle la fonction NmrRegisterProvider pour s’inscrire auprès de la NMR.
La RMN appelle la fonction de rappel ProviderCleanupBindingContext d’un module fournisseur à n’importe quel irQL <= DISPATCH_LEVEL.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows. |
| Plateforme cible | Windows |
| En-tête | netioddk.h (inclure Wsk.h) |
| IRQL | <= DISPATCH_LEVEL |