функция обратного вызова NPI_PROVIDER_CLEANUP_BINDING_CONTEXT_FN (netioddk.h)
Функция обратного вызова модуля поставщика ProviderCleanupBindingContext выполняет любую необходимую очистку и удаление контекста привязки модуля поставщика после того, как модуль поставщика и клиентский модуль отсоединились друг от друга.
Синтаксис
NPI_PROVIDER_CLEANUP_BINDING_CONTEXT_FN NpiProviderCleanupBindingContextFn;
void NpiProviderCleanupBindingContextFn(
[in] PVOID ProviderBindingContext
)
{...}
Параметры
[in] ProviderBindingContext
Указатель на контекст модуля поставщика для привязки между модулем поставщика и клиентским модулем, из которого он отсоединился. Функция обратного вызова модуля поставщика ProviderAttachClient возвращает этот указатель на NMR при подключении к клиентскому модулю.
Возвращаемое значение
Никакой
Замечания
NMR вызывает функцию обратного вызова модуля поставщика ProviderCleanupBindingContext после того, как поставщик и клиентский модуль отсоединились друг от друга.
Функция обратного вызова модуля поставщика ProviderCleanupBindingContext должна выполнять любую необходимую очистку данных, содержащихся в структуре контекста привязки модуля поставщика. Затем он должен освободить память для структуры контекста привязки, если модуль поставщика динамически выделяет память для структуры.
Если модуль поставщика не динамически выделяет память для контекста привязки и никакой другой очистки контекста привязки не требуется, модуль поставщика не должен реализовать функцию обратного вызова ProviderCleanupBindingContext. Если модуль поставщика не реализует функцию обратного вызова ProviderCleanupBindingContext, необходимо задать ProviderCleanupBindingContext члена NPI_PROVIDER_CHARACTERISTICS структуру NULL при вызове функции nmrRegisterProvider nmrRegisterProvider для регистрации в NMR.
NMR вызывает функцию обратного вызова модуля поставщика ProviderCleanupBindingContext при любом <IRQL = DISPATCH_LEVEL.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Windows Vista и более поздних версиях операционных систем Windows. |
| целевая платформа | Виндоус |
| заголовка | netioddk.h (include Wsk.h) |
| IRQL | <= DISPATCH_LEVEL |