NPI_PROVIDER_CLEANUP_BINDING_CONTEXT_FN funzione di callback (netioddk.h)
La ProviderCleanupBindingContext di un modulo provider funzione di callback esegue le operazioni di pulizia e deallocazione necessarie del contesto di associazione del modulo provider dopo che il modulo provider e un modulo client sono stati scollegati l'uno dall'altro.
Sintassi
NPI_PROVIDER_CLEANUP_BINDING_CONTEXT_FN NpiProviderCleanupBindingContextFn;
void NpiProviderCleanupBindingContextFn(
[in] PVOID ProviderBindingContext
)
{...}
Parametri
[in] ProviderBindingContext
Puntatore al contesto del modulo del provider per l'associazione tra il modulo del provider e il modulo client da cui è stato scollegato. Il modulo provider ProviderAttachClient funzione di callback restituisce questo puntatore al nmR quando si connette al modulo client.
Valore restituito
Nessuno
Osservazioni
NmR chiama la ProviderCleanupBindingContext di un modulo del provider funzione di callback dopo che il provider e un modulo client si sono scollegati l'uno dall'altro.
Il ProviderCleanupBindingContext di un modulo del provider funzione di callback deve eseguire qualsiasi pulizia necessaria dei dati contenuti nella struttura del contesto di associazione del modulo del provider. Sarà quindi necessario liberare la memoria per la struttura del contesto di associazione se il modulo del provider ha allocato dinamicamente la memoria per la struttura.
Se il modulo provider non alloca dinamicamente la memoria per il contesto di associazione e non è necessaria alcuna altra pulizia del contesto di associazione, il modulo provider non deve implementare un ProviderCleanupBindingContext funzione di callback. Se il modulo provider non implementa un ProviderCleanupBindingContext funzione di callback, deve impostare il ProviderCleanupBindingContext membro del NPI_PROVIDER_CHARACTERISTICS struttura per NULL quando chiama la funzione di NmrRegisterProvider per registrarsi con NMR.
NMR chiama la ProviderCleanupBindingContext di un modulo del provider funzione di callback in qualsiasi <IRQL = DISPATCH_LEVEL.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
| piattaforma di destinazione | Finestre |
| intestazione | netioddk.h (include Wsk.h) |
| IRQL | <= DISPATCH_LEVEL |