Compartir a través de

FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA 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 VmbChannelInitSetMaximumExternalData establece el tamaño máximo y la longitud de cadena de los datos descritos por un paquete, pero no se envían directamente en el paquete. Es decir, el tamaño máximo del búfer descrito por externalDataMdl.

Sintaxis

FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA FnVmbChannelInitSetMaximumExternalData;

NTSTATUS FnVmbChannelInitSetMaximumExternalData(
  VMBCHANNEL Channel,
  UINT32 DataSize,
  UINT32 ChainLength
)
{...}

Parámetros

Channel

Puntero a un canal de biblioteca cliente de modo kernel (KMCL).

DataSize

Tamaño máximo de datos externos.

ChainLength

Número máximo de Listas de descriptores de memoria (MDL) en una cadena MDL entrante.

Valor devuelto

VmbChannelInitSetMaximumExternalData puede devolver uno de los siguientes valores de estado:

Código devuelto Descripción
STATUS_SUCCESS
 La función finalizó correctamente.
STATUS_INVALID_PARAMETER_1
 El valor del canal no era válido o estaba en un estado no válido, como Deshabilitado.
STATUS_INVALID_PARAMETER_2
 El valor DataSize no es válido. Cero (0) no es válido.
STATUS_INVALID_PARAMETER_3
 El valor ChainLength no es válido. Cero (0) no es válido.

Comentarios

La KMCL garantiza que los búferes de anillo son lo suficientemente grandes como para enviar paquetes que contienen búferes en los límites especificados.

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