SerCxRetrieveTransmitMdl, fonction (sercx.h)

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

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 dans le MDL.

Valeur de retour

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

Retourner le code

Description

STATUS_INVALID_DEVICE_REQUEST

Cette valeur est retournée si l’une des opérations suivantes se produit : Il n’existe aucune demande de transmission en attente d’obtention d’un 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) actuelle. 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 ce MDL jusqu’à ce qu’il appelle la méthode SerCxProgressTransmit, après laquelle le pointeur MDL n’est pas valide et que 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 MDLs.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible à partir de Windows 8.
plateforme cible	Universel
d’en-tête	sercx.h
IRQL	<= DISPATCH_LEVEL

Voir aussi

SerCxProgressTransmit