Compartir a través de

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

  • Artículo

[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í.]

La función VmbChannelSaveContinue guarda el estado del canal en un búfer. Ejecute el 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.

Observaciones

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ó espacio suficiente de antemano, es posible que se necesiten varias llamadas.

Importante

Esta función se llama a través de la interfaz de la 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 Valor
cliente mínimo admitido Windows 10, versión 1803
encabezado de vmbuskernelmodeclientlibapi.h

Consulte también

VmbChannelSaveBegin