Compartir a través de


EVT_VMB_CHANNEL_SAVE_PACKET 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 de devolución de llamada EvtVmbChannelSavePacket se invoca cuando el punto de conexión del proveedor de servicios de virtualización (VSP) debe guardar el estado asociado a un paquete.

Sintaxis

EVT_VMB_CHANNEL_SAVE_PACKET EvtVmbChannelSavePacket;

NTSTATUS EvtVmbChannelSavePacket(
  [in]  VMBCHANNEL Channel,
  [in]  VMBPACKET Packet,
  [out] PVOID SaveBuf,
  [in]  UINT32 SaveBufSize,
  [out] PUINT32 BytesNeeded
)
{...}

Parámetros

[in] Channel

Canal en el que llega el paquete.

[in] Packet

Paquete para el que VSP guarda el estado.

[out] SaveBuf

Búfer en el que se va a guardar el estado.

[in] SaveBufSize

Tamaño del parámetro SaveBuf , en bytes.

[out] BytesNeeded

Tamaño necesario para guardar el estado de la transacción, en bytes.

Valor devuelto

EvtVmbChannelSavePacket devuelve un código de estado.

Comentarios

La función VmbServerChannelInitSetSaveRestorePacketCallbacks establece una función de devolución de llamada para guardar paquetes para cada canal.

VSP guarda el estado asociado a la transacción que es exclusiva del VSP. La biblioteca cliente del modo kernel (KMCL) guarda su propio estado.

Esta función se invoca para cada objeto de paquete que está actualmente en uso. La primera invocación pasa un valor cero (0) para el parámetro SaveBufSize . Esta llamada produce un error si hay algún estado que deba guardarse, que rellena BytesNeeded con el requisito de tamaño real. Si esta primera invocación devuelve un código de error, la KMCL llama una segunda vez con un búfer de al menos la longitud estipulada en la primera llamada.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado vmbuskernelmodeclientlibapi.h (incluya VmbusKernelModeClientLibApi.h)
IRQL PASSIVE_LEVEL

Consulte también

VmbServerChannelInitSetSaveRestorePacketCallbacks