Función SerCx2CustomReceiveTransactionReportProgress (sercx.h)
El método SerCx2CustomReceiveTransactionReportProgress informa de si se está realizando un progreso para completar la transacción de recepción personalizada actual.
Sintaxis
void SerCx2CustomReceiveTransactionReportProgress(
SERCX2CUSTOMRECEIVETRANSACTION CustomReceiveTransaction,
[in] SERCX2_CUSTOM_RECEIVE_TRANSACTION_PROGRESS Progress
);
Parámetros
CustomReceiveTransaction
Identificador de SERCX2CUSTOMRECEIVETRANSACTION a un objeto de recepción personalizado. El controlador de controlador serie llamó anteriormente al método SerCx2CustomReceiveTransactionCreate para crear este objeto.
[in] Progress
Si se está realizando un progreso para completar la transacción de recepción personalizada. Establezca este parámetro en una de las siguientes constantes de enumeración:
- SERCX2_CUSTOM_RECEIVE_NO_PROGRESS
- SERCX2_CUSTOM_RECEIVE_BYTES_TRANSFERRED
Valor devuelto
Ninguno
Observaciones
Para determinar si el controlador serie está progresando para completar la transacción de recepción personalizada actual, SerCx2 llama periódicamente a la función de devolución de llamada de eventos EvtSerCx2CustomReceiveTransactionQueryProgress. En respuesta a esta llamada, el controlador de controlador serie llama a serCx2CustomReceiveTransactionReportProgress para proporcionar un informe de progreso.
Cada SerCx2CustomReceiveTransactionReportProgress llamada informa de si se han transferido bytes de datos en la transacción de recepción personalizada actual desde la llamada anterior a este método o el inicio de la transacción, lo que sea más reciente. Si se han transferido uno o varios bytes, la llamada informa de que el controlador serie está progresando. Si no se han transferido bytes, la llamada informa de que no hay ningún progreso.
El controlador del controlador serie debe llamar a este método solo en respuesta a una llamada de SerCx2 a la función EvtSerCx2CustomReceiveTransactionQueryProgress.
Para obtener más información, vea SerCx2 Custom-Receive Transactions.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible a partir de Windows 8.1. |
| de la plataforma de destino de |
Universal |
| encabezado de |
sercx.h |
| irQL | <= DISPATCH_LEVEL |
Consulte también
EvtSerCx2CustomReceiveTransactionQueryProgress
SERCX2CUSTOMRECEIVETRANSACTION