Compartir a través de

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

  • Artículo

[Parte de la información hace referencia a la versión preliminar del producto, el cual puede sufrir importantes modificaciones antes de que se publique la versión comercial. Microsoft no ofrece ninguna garantía, expresa o implícita, con respecto a la información que se ofrece aquí].

La función VmbClientChannelInitSetTargetPnp establece el destino de un canal de cliente por tipo de interfaz e identificadores de instancia. Si se llama a esta función, la biblioteca cliente del modo kernel (KMCL) usa PnP para buscar el objeto de dispositivo físico (PDO) VMBus que corresponde a la interfaz proporcionada.

Sintaxis

FN_VMB_CLIENT_CHANNEL_INIT_SET_TARGET_PNP FnVmbClientChannelInitSetTargetPnp;

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

Parámetros

Channel

Puntero a un canal.

InterfaceType

Puntero al GUID de tipo de interfaz. Este GUID identifica el tipo de canal y el protocolo que se usa con el canal.

InterfaceInstance

Puntero al GUID de tipo de instancia. Se trata de una instancia específica del servicio. Si no se proporciona, se acepta cualquier instancia con el tipo proporcionado.

PnpFailureCallback

Puntero a una devolución de llamada de evento para llamar a si el dispositivo no se puede conectar de forma asincrónica aunque se encuentre el dispositivo PnP.

Valor devuelto

VmbClientChannelInitSetTargetPnp devuelve los siguientes valores:

Código devuelto Descripción
STATUS_INVALID_PARAMETER_1
 El valor del canal no era válido o estaba en un estado no válido, como Deshabilitado.

Comentarios

Si tiene dos interfaces de red paravirtuales, tendrán los mismos valores InterfaceType pero diferentes interfaceInstance .

Importante

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

Para obtener más información, vea la sección Comentarios del KMCL_CLIENT_INTERFACE_V1.

Requisitos

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