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 |
|---|---|
|
La función finalizó correctamente. |
|
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 |