EVT_VMB_CHANNEL_SAVE_PACKET función de devolución de llamada (vmbuskernelmodeclientlibapi.h)
[Cierta información se relaciona con el producto publicado previamente que puede modificarse sustancialmente antes de su publicación comercial. Microsoft no ofrece ninguna garantía, expresa o implícita, con respecto a la información proporcionada aquí.]
El EvtVmbChannelSavePacket función de devolución de llamada 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.
Observaciones
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 tenga que guardarse, lo que rellena el bytesneeded de 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 | Valor |
|---|---|
| de la plataforma de destino de | Windows |
| encabezado de | vmbuskernelmodeclientlibapi.h (incluya VmbusKernelModeClientLibApi.h) |
| irQL | PASSIVE_LEVEL |