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

[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 VmbPacketInitialize inicializa un búfer para que contenga un paquete VMBus.

Sintaxis

FN_VMB_PACKET_INITIALIZE FnVmbPacketInitialize;

NTSTATUS FnVmbPacketInitialize(
  VMBCHANNEL Channel,
  VMBPACKET VmbPacket,
  UINT32 ByteCount
)
{...}

Parámetros

Channel

Identificador de un canal.

VmbPacket

Búfer que se va a usar para almacenar el paquete VMBus.

ByteCount

Tamaño del búfer, en bytes.

Valor devuelto

VmbPacketInitialize devuelve los siguientes códigos de estado:

Código devuelto	Descripción
STATUS_SUCCESS	La función finalizó correctamente.
STATUS_INVALID_PARAMETER_3	El valor de ByteCount no es válido. Debe ser mayor que el tamaño máximo del paquete más el tamaño de un puntero void.

Comentarios

El tamaño del búfer debe ser al menos el tamaño calculado mediante la función VmbChannelSizeofPacket .

VmbPacketInitialize es una alternativa a la función VmbPacketAllocate . Use la función actual si el autor de la llamada proporciona la memoria para el objeto de paquete.

La rutina de finalización inicial del paquete no es válida y debe establecerse antes de enviar el paquete.

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

VmbChannelSizeofPacket

VmbPacketAllocate