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

[Некоторые сведения связаны с предварительно выпущенным продуктом, который может быть существенно изменен до его коммерческого выпуска. Корпорация Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых в отношении информации, предоставленной здесь.]

Функция VmbChannelInitSetProcessPacketCallbacks задает функции обратного вызова для обработки пакетов.

Синтаксис

FN_VMB_CHANNEL_INIT_SET_PROCESS_PACKET_CALLBACKS FnVmbChannelInitSetProcessPacketCallbacks;

NTSTATUS FnVmbChannelInitSetProcessPacketCallbacks(
  VMBCHANNEL Channel,
  PFN_VMB_CHANNEL_PROCESS_PACKET ProcessPacketCallback,
  PFN_VMB_CHANNEL_PROCESSING_COMPLETE ProcessingCompleteCallback
)
{...}

Параметры

Channel

Дескриптор канала.

ProcessPacketCallback

Функция обратного вызова для вызова, когда пакет готов к обработке.

ProcessingCompleteCallback

Функция обратного вызова для вызова при обработке пакета пакетов завершена.

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

VmbChannelInitSetProcessPacketCallbacks возвращает одно из следующих значений состояния:

Возвращаемый код Описание
STATUS_SUCCESS
 Функция успешно завершена.
STATUS_INVALID_PARAMETER_1
 Значение канала недопустимо или в недопустимом состоянии, например "Отключено".

Замечания

Эта функция имеет смысл только в том случае, если управление очередью в режиме ядра (KMCL) не подавляется.

ProcessPacketCallback вызывается для каждого полученного пакета. EvtVmbChannelProcessingComplete будет вызываться каждый раз, когда кольцевой буфер, содержащий входящие пакеты, переходят от непустого к пустому. Это происходит после последнего вызова ProcessPacketCallback в одном пакете.

Важный

Эта функция вызывается через клиентский интерфейс клиентской библиотеки режима ядра VMBus (KMCL), предоставляемый драйвером шины Vmbkmcl.sys. Это клиентская функция, доступ к ней осуществляется из структуры KMCL_CLIENT_INTERFACE_V1.

Дополнительные сведения см. в разделе "Примечания" KMCL_CLIENT_INTERFACE_V1.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 10 версии 1803
заголовка vmbuskernelmodeclientlibapi.h

См. также

EvtVmbChannelProcessingComplete

ProcessPacketCallback

  • Last updated on