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 après le module fournisseur et un module client.
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 à partir duquel il a détaché. La fonction de rappel ProviderAttachClient du module fournisseur retourne ce pointeur vers la NMR lorsqu’elle est attachée au module client.
Valeur de retour
Aucun
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 les uns des autres.
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 à 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 ProviderCleanupBindingContext membre du NPI_PROVIDER_CHARACTERISTICS structure pour NULL lorsqu’elle appelle la fonction NmrRegisterProvider pour s’inscrire auprès de la NMR.
La NMR appelle la fonction de rappel ProviderCleanupBindingContext d’un module fournisseur à tout <IRQL = DISPATCH_LEVEL.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows. |
| plateforme cible | Windows |
| d’en-tête | netioddk.h (include Wsk.h) |
| IRQL | <= DISPATCH_LEVEL |