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

Статья
02/07/2025

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

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

Синтаксис

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

Поделиться через