функция обратного вызова NPI_CLIENT_CLEANUP_BINDING_CONTEXT_FN (netioddk.h)

  • Статья

Функция обратного вызова ClientCleanupBindingContext клиентского модуля выполняет любую необходимую очистку и освобождение контекста привязки клиентского модуля после отсоединения клиентского модуля и модуля поставщика друг от друга.

Синтаксис

NPI_CLIENT_CLEANUP_BINDING_CONTEXT_FN NpiClientCleanupBindingContextFn;

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

Параметры

[in] ClientBindingContext

Указатель на контекст клиентского модуля для привязки между клиентским модулем и модулем поставщика, от которого он отсоединился. Клиентский модуль передает этот указатель в NMR при вызове функции NmrClientAttachProvider для подключения к модулю поставщика.

Возвращаемое значение

None

Remarks

NMR вызывает функцию обратного вызова ClientCleanupBindingContext клиентского модуля после того, как клиентский модуль и модуль поставщика отсоединились друг от друга.

Функция обратного вызова ClientCleanupBindingContext клиентского модуля должна выполнять необходимую очистку данных, содержащихся в структуре контекста привязки клиентского модуля. Затем он должен освободить память для структуры контекста привязки, если клиентский модуль динамически выделил память для структуры.

Если клиентский модуль не выделяет память динамически для контекста привязки и никакой другой очистки контекста привязки не требуется, то клиентскому модулю не нужно реализовывать функцию обратного вызова ClientCleanupBindingContext . Если клиентский модуль не реализует функцию обратного вызова ClientCleanupBindingContext, необходимо задать элемент ClientCleanupBindingContext NPI_CLIENT_CHARACTERISTICS структуры значение NULL при вызове функции NmrRegisterClient для регистрации в NMR.

NMR вызывает функцию обратного вызова ClientCleanupBindingContext клиентского модуля при любом irQL <= DISPATCH_LEVEL.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Целевая платформа Windows
Header netioddk.h (включая Wsk.h)
IRQL <= DISPATCH_LEVEL

См. также раздел

ClientAttachProvider

ClientDetachProvider

NPI_CLIENT_CHARACTERISTICS

NmrClientAttachProvider

ProviderDetachClient