Compartir a través de

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

  • Artículo

[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 VmbChannelSaveContinue guarda el estado del canal en un búfer. Ejecute VmbChannelSaveBegin antes de ejecutar esta función. El controlador debe comprobar el valor devuelto de la función.

Sintaxis

FN_VMB_CHANNEL_SAVE_CONTINUE FnVmbChannelSaveContinue;

NTSTATUS FnVmbChannelSaveContinue(
  VMBCHANNEL Channel,
  PVOID SaveBuffer,
  ULONG SaveBufferSize,
  PULONG BytesFilled,
  PULONG BytesRequired
)
{...}

Parámetros

Channel

Identificador de un canal que se va a guardar.

SaveBuffer

Puntero al búfer en el que se va a guardar la información de estado.

SaveBufferSize

Tamaño, en bytes, del búfer de guardado.

BytesFilled

Puntero a una variable que recibe el número de bytes que se copiaron en el búfer de guardado.

BytesRequired

Puntero a una variable que recibe el número de bytes necesarios para que esta función realice el progreso en la siguiente llamada.

Valor devuelto

VmbChannelSaveContinue devuelve los siguientes valores:

Código devuelto Descripción
STATUS_SUCCESS
 El estado se guardó.
STATUS_BUFFER_TOO_SMALL
El búfer de guardado era demasiado pequeño. El parámetro BytesNeeded contiene el número de bytes necesarios para realizar cualquier progreso.
STATUS_STATUS_BUFFER_OVERFLOW
 Algunos datos se escribieron en el búfer de guardado, pero hay más datos que se van a guardar.

Comentarios

El proceso de guardado guarda los datos en "fragmentos" y puede continuar desde el punto en que se detuvo.

Si el autor de la llamada no asignó suficiente espacio de antemano, es posible que se necesiten varias llamadas.

Importante

Esta función se llama a través de la interfaz biblioteca cliente del modo kernel (KMCL) de VMBus, proporcionada por el controlador de bus de Vmbkmcl.sys. Se trata de una función de solo servidor a la que se accede desde la estructura de KMCL_SERVER_ONLY_METHODS .

Para obtener más información, vea la sección Comentarios de KMCL_SERVER_ONLY_METHODS.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1803
Encabezado vmbuskernelmodeclientlibapi.h

Consulte también

VmbChannelSaveBegin