SerCx2SaveReceiveFifoOnD0Exit, fonction (sercx.h)

Article
10/30/2024

La méthode SerCx2SaveReceiveFifoOnD0Exit informe la version 2 de l’extension de framework série (SerCx2) que le fiFO de réception du matériel du contrôleur série contient des données qui doivent être enregistrées avant que le contrôleur série n’entre dans un état d’alimentation faible de l’appareil.

Syntaxe

void SerCx2SaveReceiveFifoOnD0Exit(
  [in] SERCX2PIORECEIVE PioReceive,
  [in] ULONG            FifoSize
);

Paramètres

[in] PioReceive

Handle SERCX2PIORECEIVE à un objet de réception d’authentification unique. Le pilote du contrôleur série a précédemment appelé la méthode SerCx2PioReceiveCreate pour créer cet objet.

[in] FifoSize

Nombre d’octets de données non lues que contient le FIFO de transmission.

Valeur de retour

Aucun

Remarques

Lorsque le contrôleur série est sur le point d’entrer un état à faible alimentation, SerCx2 et le pilote du contrôleur série doivent enregistrer les octets de données non lues qui peuvent rester dans le FIFO de réception. Dans le cas contraire, ces données seront perdues lorsque le contrôleur série entre dans l’état de faible alimentation. Pour demander de l’aide auprès de SerCx2 pour enregistrer ces données, le pilote appelle SerCx2SaveReceiveFifoOnD0Exit.

L’infrastructure du pilote appelle la fonction de rappel d’événements EvtDeviceD0Exit ou EvtDeviceD0ExitPreInterruptsDisabled disabled pour indiquer au pilote de préparer le contrôleur série pour quitter l’état de l’appareil D0. En réponse, cette fonction désactive d’abord le prêt à envoyer ligne (RTS) pour indiquer à l’appareil à l’autre extrémité de la connexion série de ne plus envoyer de données. Ensuite, la fonction appelle SerCx2SaveReceiveFifoOnD0Exit.

SerCx2SaveReceiveFifoOnD0Exit appelle la fonction de rappel d’événement EvtSerCx2PioReceiveReadBuffer du pilote pour récupérer les données de la fonction FIFO de réception. Dans cet appel, SerCx2 fournit, en tant que paramètre, un pointeur vers une mémoire tampon logicielle interne que SerCx2 gère dans le but d’enregistrer des données non lues à partir de la FIFO de réception en préparation pour entrer un état à faible alimentation.

Plus tard, après qu’un client envoie une demande de lecture (IRP_MJ_READ) au contrôleur série, SerCx2 copie les octets de cette mémoire tampon logicielle interne vers la mémoire tampon de lecture dans la requête.