NPI_PROVIDER_CLEANUP_BINDING_CONTEXT_FN funzione di callback (netioddk.h)

La funzione di callback provider ProviderCleanupBindingContext esegue qualsiasi pulizia e deallocazione necessaria del contesto di associazione del modulo del provider dopo il modulo provider e un modulo client sono stati scollegati tra loro.

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 provider e il modulo client da cui è stato scollegato. La funzione di callback provider del modulo ProviderAttachClient restituisce questo puntatore al nmR quando si collega al modulo client.

Valore restituito

nessuno

Osservazioni

NmR chiama la funzione di callback provider providerCleanupBindingContext dopo che il provider e un modulo client sono stati scollegati tra loro.

La funzione di callback provider ProviderCleanupBindingContext deve eseguire qualsiasi pulizia necessaria dei dati contenuti nella struttura del contesto di associazione del modulo del provider. Deve quindi liberare la memoria per la struttura del contesto di associazione se il modulo provider alloca 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 una funzione di callback ProviderCleanupBindingContext . Se il modulo del provider non implementa una funzione di callback ProviderCleanupBindingContext, deve impostare il membro ProviderCleanupBindingContext dell'oggetto NPI_PROVIDER_CHARACTERISTICS struttura a NULL quando chiama la funzione NmrRegisterProvider per registrarsi con nmR.

NmR chiama la funzione di callback provider providerCleanupBindingContext in qualsiasi irQL <= DISPATCH_LEVEL.

Requisiti

Vedi anche

ClientDetachProvider

NPI_PROVIDER_CHARACTERISTICS

ProviderAttachClient

ProviderDetachClient