Fonction SerCxRetrieveTransmitMdl (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
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 |
---|---|
|
Cette valeur est retournée si l’une des opérations suivantes se produit :
|
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 |