NPI_CLIENT_CLEANUP_BINDING_CONTEXT_FN fonction de rappel (netioddk.h)

La fonction de rappel ClientCleanupBindingContext d’un module client effectue le nettoyage et la délocalisation nécessaires du contexte de liaison du module client une fois que le module client et un module fournisseur se sont détachés l’un de l’autre.

Syntaxe

NPI_CLIENT_CLEANUP_BINDING_CONTEXT_FN NpiClientCleanupBindingContextFn;

void NpiClientCleanupBindingContextFn(
  [in] PVOID ClientBindingContext
)
{...}

Paramètres

[in] ClientBindingContext

Pointeur vers le contexte du module client pour la liaison entre le module client et le module fournisseur dont il s’est détaché. Le module client transmet ce pointeur à la RMN lorsqu’il appelle la fonction NmrClientAttachProvider à attacher au module fournisseur.

Valeur de retour

None

Remarques

La RMN appelle la fonction de rappel ClientCleanupBindingContext d’un module client après que le module client et un module fournisseur se sont détachés l’un de l’autre.

La fonction de rappel ClientCleanupBindingContext d’un module client doit effectuer tout nettoyage nécessaire des données contenues dans la structure de contexte de liaison du module client. Il doit ensuite libérer la mémoire pour la structure de contexte de liaison si le module client a alloué dynamiquement la mémoire pour la structure.

Si le module client n’alloue pas dynamiquement la mémoire pour son contexte de liaison et qu’aucun autre nettoyage de son contexte de liaison n’est requis, le module client n’a pas besoin d’implémenter une fonction de rappel ClientCleanupBindingContext . Si le module client n’implémente pas de fonction de rappel ClientCleanupBindingContext , il doit définir le membre ClientCleanupBindingContext du NPI_CLIENT_CHARACTERISTICS la structure null quand elle appelle la fonction NmrRegisterClient pour s’inscrire auprès de la rmN.

La RMN appelle la fonction de rappel ClientCleanupBindingContext d’un module client à n’importe quelle valeur IRQL <= DISPATCH_LEVEL.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible Windows
En-tête netioddk.h (inclure Wsk.h)
IRQL <= DISPATCH_LEVEL

Voir aussi

ClientAttachProvider

ClientDetachProvider

NPI_CLIENT_CHARACTERISTICS

NmrClientAttachProvider

ProviderDetachClient