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 |