SerCxRetrieveReceiveMdl, fonction (sercx.h)

Article
02/26/2024

La méthode SerCxRetrieveReceiveMdl récupère le MDL qui décrit la mémoire tampon à utiliser pour recevoir le bloc de données d’entrée suivant.

Syntaxe

NTSTATUS SerCxRetrieveReceiveMdl(
  [in]  WDFDEVICE Device,
  [out] PMDL      *Mdl
);

Paramètres

[in] Device

Un handle WDFDEVICE pour l’objet d’appareil framework qui représente le contrôleur série.

[out] Mdl

Pointeur vers un emplacement dans lequel la méthode écrit un pointeur vers la MDL.

Valeur retournée

SerCxRetrieveReceiveMdl retourne STATUS_SUCCESS si l’appel réussit. Les valeurs de retour possibles incluent les codes d’erreur suivants.

Code de retour	Description
STATUS_INVALID_DEVICE_REQUEST	Cette valeur est retournée si l’une des opérations suivantes se produit : Il n’y a aucune demande de réception en attente pour obtenir une MDL. Le nombre actuel d’octets reçus (tel que signalé par la méthode SerCxProgressReceive ) n’est pas égal à zéro. La mémoire tampon a déjà été récupérée (et l’appel correspondant à la méthode SerCxProgressReceive n’a pas encore eu lieu). La MDL a déjà été récupérée (et l’appel correspondant à la méthode SerCxProgressReceive n’a pas encore eu lieu).

Code de retour

Description

STATUS_INVALID_DEVICE_REQUEST

Cette valeur est retournée si l’une des opérations suivantes se produit :

Il n’y a aucune demande de réception en attente pour obtenir une MDL.
Le nombre actuel d’octets reçus (tel que signalé par la méthode SerCxProgressReceive ) n’est pas égal à zéro.
La mémoire tampon a déjà été récupérée (et l’appel correspondant à la méthode SerCxProgressReceive n’a pas encore eu lieu).
La MDL a déjà été récupérée (et l’appel correspondant à la méthode SerCxProgressReceive n’a pas encore eu lieu).

Remarques

Le pilote du contrôleur série appelle cette fonction pour obtenir un MDL à utiliser pour l’opération de réception (lecture) en cours. La MDL décrit la mémoire tampon dans laquelle le pilote doit transférer les données reçues. Le pilote est le propriétaire exclusif de cette MDL jusqu’à ce qu’il appelle la méthode SerCxProgressReceive , après quoi le pointeur MDL n’est pas valide et le pilote ne doit plus essayer d’accéder à la MÉMOIRE MDL ou à la mémoire tampon décrite par le MDL.

Pour plus d’informations sur les DLL, consultez Utilisation de MDL.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 8.
Plateforme cible	Universal
En-tête	sercx.h
IRQL	<= DISPATCH_LEVEL

Voir aussi

SerCxProgressReceive

Partager via