FN_VMB_SERVER_CHANNEL_INIT_SET_TARGET_INTERFACE_ID función de devolución de llamada (vmbuskernelmodeclientlibapi.h)

La función VmbServerChannelInitSetTargetInterfaceId establece el GUID de tipo de interfaz de destino y el GUID de instancia de la oferta del canal.

Sintaxis

FN_VMB_SERVER_CHANNEL_INIT_SET_TARGET_INTERFACE_ID FnVmbServerChannelInitSetTargetInterfaceId;

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

Parámetros

Channel

Identificador de un canal.

InterfaceType

Puntero al GUID del tipo de interfaz.

InterfaceInstance

Puntero al GUID de tipo de instancia.

Valor devuelto

Devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, devuelve un código de error NTSTATUS adecuado.

Comentarios

El GUID interfaceType identifica el tipo de canal y, en concreto, el protocolo que se usa con el canal. Si vmBus de la partición secundaria está creando un objeto de dispositivo físico (PDO) asociado a este canal, este GUID es la base del identificador de hardware del PDO notificado al administrador de PnP.

El GUID de InterfaceInstance identifica una instancia específica del servicio. Por ejemplo, si tiene dos interfaces de red paravirtuales, tienen el mismo tipo de interfaz, pero valores de instancia de interfaz diferentes.

Importante

Esta función se llama a través de la interfaz de la biblioteca cliente del modo kernel de VMBus (KMCL), proporcionada por el controlador de bus de Vmbkmcl.sys. Se trata de una función de solo servidor a la que se accede desde la estructura de KMCL_SERVER_ONLY_METHODS .

Para obtener más información, vea la sección Comentarios de KMCL_SERVER_ONLY_METHODS.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1809
Encabezado vmbuskernelmodeclientlibapi.h