Compartir a través de

Función SerCxProgressReceive (sercx.h)

  • Artículo

El método SerCxProgressReceive informa del progreso de la operación de lectura (recepción) actual.

Sintaxis

NTSTATUS SerCxProgressReceive(
  [in] WDFDEVICE    Device,
  [in] ULONG        BytesReceived,
  [in] SERCX_STATUS ReceiveStatus
);

Parámetros

[in] Device

Un identificador WDFDEVICE para el objeto de dispositivo de marco que representa el controlador serie.

[in] BytesReceived

Número de bytes de datos que el autor de la llamada cargó en el búfer de recepción obtenido por la última llamada al método SerCxRetrieveReceiveBuffer.

[in] ReceiveStatus

Estado actual de la operación de recepción. Establezca este parámetro en uno de los siguientes valores:

  • SerCxStatusSuccess
  • SerCxStatusCancelled
  • SerCxStatusTimeout
Para obtener más información sobre estos valores, vea SERCX_STATUS.

Valor devuelto

serCxProgressReceive devuelve STATUS_SUCCESS si se realiza correctamente. Entre los posibles valores devueltos de error se incluyen los siguientes códigos de estado.

Código devuelto Descripción
STATUS_INVALID_PARAMETER
 El valor de BytesReceived de supera la longitud del búfer disponible; o el valor ReceiveStatus no es válido.
STATUS_INVALID_DEVICE_REQUEST
 Se llamó al método en irQL incorrecto; o el identificador WDFDEVICE no es válido; o el controlador no ha obtenido un búfer de entrada para esta operación de recepción.
STATUS_CANCELLED
 La operación de recepción ya se ha cancelado.

Observaciones

El controlador del controlador serie llama a este método para notificar el progreso de una operación de lectura pendiente. Normalmente, el controlador del controlador serie llama a este método desde su devolución de llamada de finalización DMA (si el controlador usa DMA para leer los datos) o desde su función DPC de transmisión/recepción (si se usa PIO).

Si el SerCxProgressReceive no completa todo el trabajo pendiente para la operación de lectura, el autor de la llamada debe llamar al método SerCxRetrieveReceiveBuffer para obtener un nuevo descriptor de búfer y continuar recibiendo datos.

Requisitos

Requisito Valor
cliente mínimo admitido Disponible a partir de Windows 8.
de la plataforma de destino de Universal
encabezado de sercx.h
irQL <= DISPATCH_LEVEL

Consulte también

SERCX_STATUS

serCxRetrieveReceiveBuffer