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

  • Статья

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

Функция VmbClientChannelInitSetTargetPnp задает целевой объект клиентского канала по типу интерфейса и идентификаторам экземпляров. При вызове этой функции клиентская библиотека режима ядра (KMCL) использует PnP для поиска объекта физического устройства (PDO) виртуальной машины VMBus, соответствующего предоставленному интерфейсу.

Синтаксис

FN_VMB_CLIENT_CHANNEL_INIT_SET_TARGET_PNP FnVmbClientChannelInitSetTargetPnp;

NTSTATUS FnVmbClientChannelInitSetTargetPnp(
  VMBCHANNEL Channel,
  LPCGUID InterfaceType,
  LPCGUID InterfaceInstance,
  PFN_VMB_CHANNEL_PNP_FAILURE PnpFailureCallback
)
{...}

Параметры

Channel

Указатель на канал.

InterfaceType

Указатель на GUID типа интерфейса. Этот GUID определяет тип канала и протокол, используемый с каналом.

InterfaceInstance

Указатель на GUID типа экземпляра. Это конкретный экземпляр службы. Если этот параметр не указан, принимается любой экземпляр с указанным типом.

PnpFailureCallback

Указатель на обратный вызов события для вызова, если устройство асинхронно не удается подключиться, даже если устройство PnP было расположено.

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

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

Код возврата Описание
STATUS_INVALID_PARAMETER_1
 Значение канала было недопустимым или находилось в недопустимом состоянии, например Отключено.

Комментарии

Если у вас есть два паравиртуальных сетевых интерфейса, они будут иметь один и тот же InterfaceType , но разные значения InterfaceInstance .

Важно!

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

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

Требования

Требование Значение
Минимальная версия клиента Windows 10 версии 1803
Верхняя часть vmbuskernelmodeclientlibapi.h