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

Статья
02/07/2025

Функция VmbServerChannelInitSetTargetInterfaceId задает GUID типа целевого интерфейса и GUID экземпляра предложения канала.

Синтаксис

FN_VMB_SERVER_CHANNEL_INIT_SET_TARGET_INTERFACE_ID FnVmbServerChannelInitSetTargetInterfaceId;

NTSTATUS FnVmbServerChannelInitSetTargetInterfaceId(
  VMBCHANNEL Channel,
  GUID InterfaceType,
  GUID InterfaceInstance
)
{...}

Параметры

Channel

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

InterfaceType

Указатель на GUID типа интерфейса.

InterfaceInstance

Указатель на GUID типа экземпляра.

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

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

Замечания

GUID интерфейса InterfaceType определяет тип канала и, в частности, протокол, используемый с каналом. Если vmBus в дочернем разделе создает объект физического устройства (PDO), связанный с этим каналом, этот GUID является основой идентификатора оборудования PDO, сообщаемого диспетчеру PnP.

Guid InterfaceInstance определяет конкретный экземпляр службы. Например, если у вас есть два паравиртуальных сетевых интерфейса, они имеют один и тот же тип интерфейса, но разные значения экземпляра интерфейса.

Важный

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

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

Требования

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

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