SerCx2SystemDmaReceiveNewDataNotification, fonction (sercx.h)
La méthode SerCx2SystemDmaReceiveNewDataNotification avertit la version 2 de l’extension de framework série (SerCx2) que les données sont disponibles pour être lues à partir du FIFO de réception dans le matériel du contrôleur série.
Syntaxe
void SerCx2SystemDmaReceiveNewDataNotification(
[in] SERCX2SYSTEMDMARECEIVE SystemDmaReceive
);
Paramètres
[in] SystemDmaReceive
Handle SERCX2SYSTEMDMARECEIVE à un objet de réception système-DMA. Le pilote du contrôleur série a précédemment appelé la méthode SerCx2SystemDmaReceiveCreate pour créer cet objet.
Valeur de retour
Aucun
Remarques
Si le FIFO de réception dans le contrôleur série devient vide avant qu’une transaction de réception système-DMA puisse être effectuée, SerCx2 appelle la EvtSerCx2SystemDmaReceiveEnableNewDataNotification fonction de rappel d’événement, si elle est implémentée, pour permettre à SerCx2 de recevoir une notification de nouvelles données lorsque les données sont à nouveau disponibles pour être lues à partir de la fonction de rappel d’événement réception.
Si la notification new-data est activée, le pilote du contrôleur série doit appeler SerCx2SystemDmaReceiveNewDataNotification pour notifier SerCx2 une fois que le contrôleur série reçoit de nouvelles données. Une notification se produit lorsque le pilote détecte qu’un ou plusieurs nouveaux octets de données reçues sont prêts à être transférés ou ont déjà été transférés par le contrôleur DMA système.
Le contrôleur série doit appeler SerCx2SystemDmaReceiveNewDataNotification uniquement en réponse à un appel à la fonction EvtSerCx2SystemDmaReceiveEnableNewDataNotification.
Si un pilote de contrôleur série prend en charge les notifications de nouvelles données pour les transactions de réception système-DMA, SerCx utilise ces notifications pour détecter les délais d’attente d’intervalle pendant la gestion des demandes de lecture (IRP_MJ_READ). Pour plus d’informations sur les délais d’attente d’intervalle, consultez SERIAL_TIMEOUTS. Pour plus d’informations sur les notifications de nouvelles données, consultez système SerCx2 System-DMA-Receive Transactions.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 8.1. |
| plateforme cible | Universel |
| d’en-tête | sercx.h |
| IRQL | <= DISPATCH_LEVEL |