Fonction SerCx2SystemDmaReceiveNewDataNotification (sercx.h)

Article
02/29/2024

La méthode SerCx2SystemDmaReceiveNewDataNotification avertit la version 2 de l’extension d’infrastructure 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

Un handle SERCX2SYSTEMDMARECEIVE à un objet system-DMA-receive. Le pilote de contrôleur série a précédemment appelé la méthode SerCx2SystemDmaReceiveCreate pour créer cet objet.

Valeur de retour

None

Remarques

Si la réception FIFO dans le contrôleur série devient vide avant qu’une transaction de réception système-DMA ne puisse être effectuée, SerCx2 appelle la fonction de rappel d’événement EvtSerCx2SystemDmaReceiveEnableNewDataNotification , 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 fiFO de réception.

Si la notification de nouvelles données est activée, le pilote de contrôleur série doit appeler SerCx2SystemDmaReceiveNewDataNotification pour notifier SerCx2 après que le contrôleur série a reçu 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 pendant la gestion des demandes de lecture (IRP_MJ_READ). Pour plus d’informations sur les délais d’attente, consultez SERIAL_TIMEOUTS. Pour plus d’informations sur les notifications de nouvelles données, consultez Transactions système-DMA-réception SerCx2.