FN_VMB_PACKET_SEND_WITH_EXTERNAL_MDL 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 VmbPacketSendWithExternalMdl envía los datos en un búfer de paquetes o en una lista de descriptores de memoria de datos externos (MDL). La función asocia esos datos con el objeto de paquete VMBus, que representa el paquete durante toda la duración de la transacción.

Sintaxis

FN_VMB_PACKET_SEND_WITH_EXTERNAL_MDL FnVmbPacketSendWithExternalMdl;

NTSTATUS FnVmbPacketSendWithExternalMdl(
  __drv_aliasesMem VMBPACKET PacketObject,
  PVOID Buffer,
  UINT32 BufferLength,
  PMDL ExternalDataMdl,
  UINT32 MdlOffset,
  UINT32 MdlLength,
  UINT32 Flags
)
{...}

Parámetros

PacketObject

Identificador del objeto de paquete VMBus.

Buffer

Búfer que contiene el paquete de comandos que se envía a través del búfer de anillo VMBus.

BufferLength

Longitud, en bytes, del búfer en el parámetro Buffer .

ExternalDataMdl

MdL que describe un búfer de datos asociado al paquete.

MdlOffset

Desplazamiento del búfer descrito por mdl donde se inician los datos.

MdlLength

Longitud del subbúfer que se va a enviar. Use 0 para toda la MDL.

Flags

Banderas. A continuación se muestran las marcas pertinentes:

Valor Significado
VMBUS_CHANNEL_FORMAT_FLAG_WAIT_FOR_COMPLETION
 Este paquete no se puede considerar completo y sus recursos no se pueden liberar hasta que un paquete de finalización vuelva del punto de conexión opuesto. Esta marca debe establecerse.
VMBUS_CHANNEL_FORMAT_FLAG_FORCE_MDL_LENGTH
 Use siempre MdlLength para la longitud de los datos externos MDL, incluso si esta longitud es mayor que el campo ByteCount del MDL. Esto solo permite superar la longitud de la MDL redondeando hasta un límite de página. Si se establece esta marca, solo se usa el primer MDL de la cadena MDL.
VMBUS_CHANNEL_FORMAT_FLAG_PAGED_BUFFER
 El búfer insertado está paginado y debe tratarse en consecuencia, lo que significa que debe copiarse antes de entrar en el nivel de DPC. Sondear los búferes en modo de usuario o controlar las infracciones de acceso es responsabilidad del autor de la llamada.

Valor devuelto

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

Comentarios

Esta función difiere de la función VmbPacketSend en que permite pasar un desplazamiento MDL y una longitud MDL.

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 cliente a la que se accede desde la estructura de 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

Consulte también

VmbPacketSend