Compartir a través de

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

  • Artículo

[Cierta información se relaciona con el producto publicado previamente que puede modificarse sustancialmente antes de su publicación comercial. Microsoft no ofrece ninguna garantía, expresa o implícita, con respecto a la información proporcionada aquí.]

La función VmbChannelInitSetMaximumExternalData establece el tamaño máximo y la longitud de cadena de los datos descritos por un paquete, pero que no se envían directamente en el paquete. Es decir, el tamaño máximo del búfer descrito por un 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 del 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 canal de no era válido o en un estado no válido, como Deshabilitado.
STATUS_INVALID_PARAMETER_2
 El valor de 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.

Observaciones

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 de la biblioteca cliente del modo kernel (KMCL) de VMBus, proporcionada por el controlador de bus de Vmbkmcl.sys. Se trata de una función cliente a la que se accede desde la estructura KMCL_CLIENT_INTERFACE_V1.

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

Requisitos

Requisito Valor
cliente mínimo admitido Windows 10, versión 1803
encabezado de vmbuskernelmodeclientlibapi.h