Fonction SerCxRetrieveTransmitMdl (sercx.h)

Article
03/01/2024

La méthode SerCxRetrieveTransmitMdl récupère le MDL qui décrit la mémoire tampon qui contient le bloc de données de sortie suivant à transmettre.

Syntaxe

NTSTATUS SerCxRetrieveTransmitMdl(
  [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 le MDL.

Valeur retournée

SerCxRetrieveTransmitMdl 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 transmission en suspens à partir de laquelle obtenir une MDL. Le nombre actuel d’octets transmis (comme indiqué par la méthode SerCxProgressTransmit ) 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 SerCxProgressTransmit n’a pas encore eu lieu). Le MDL a déjà été récupéré (et l’appel correspondant à la méthode SerCxProgressTransmit 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 transmission en suspens à partir de laquelle obtenir une MDL.
Le nombre actuel d’octets transmis (comme indiqué par la méthode SerCxProgressTransmit ) 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 SerCxProgressTransmit n’a pas encore eu lieu).
Le MDL a déjà été récupéré (et l’appel correspondant à la méthode SerCxProgressTransmit 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 transmission (écriture) en cours. Le MDL décrit la mémoire tampon à partir de laquelle le pilote doit obtenir les données à transmettre. Le pilote est le propriétaire exclusif de cette MDL jusqu’à ce qu’il appelle la méthode SerCxProgressTransmit , après quoi le pointeur MDL n’est pas valide et le pilote ne doit plus essayer d’accéder à la MDL ou à la mémoire tampon décrite par le MDL.

Pour plus d’informations sur les dll MDL, 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

SerCxProgressTransmit

Partager via