structure SERCX_BUFFER_DESCRIPTOR (sercx.h)

La structure SERCX_BUFFER_DESCRIPTOR décrit une mémoire tampon de données pour une opération de réception ou de transmission.

Syntaxe

typedef struct SERCX_BUFFER_DESCRIPTOR {
  USHORT Size;
  PUCHAR Buffer;
  ULONG  Length;
} SERCX_BUFFER_DESCRIPTOR, *PSERCX_BUFFER_DESCRIPTOR;

Membres

Size

Taille, en octets, de cette structure. Les méthodes SerCxRetrieveReceiveBuffer et SerCxRetrieveTransmitBuffer utilisent ce membre pour déterminer la version de la structure utilisée par l’appelant. La taille de cette structure peut changer dans les versions futures du fichier d’en-tête Sercx.h.

Buffer

Adresse de mémoire virtuelle de la mémoire tampon. La mémoire de la mémoire tampon n’est pas paginé.

Length

Nombre d’octets disponibles dans la mémoire tampon. Cette taille détermine le nombre maximal d’octets pouvant être transférés par l’opération de réception ou de transmission.

Remarques

Le pilote de contrôleur série utilise les informations de cette structure pour déterminer l’emplacement en mémoire à partir duquel lire les données pendant une opération de réception et où en mémoire pour écrire des données pendant une opération de transmission.

À tout moment, il ne peut pas y avoir plus d’une mémoire tampon de réception valide et d’une mémoire tampon de transmission valide. Le pilote de contrôleur appelle la méthode SerCxRetrieveReceiveBuffer pour obtenir la mémoire tampon de réception et appelle la méthode SerCxRetrieveTransmitBuffer pour obtenir la mémoire tampon de transmission. Les deux méthodes copient les descriptions de mémoire tampon dans des structures SERCX_BUFFER_DESCRIPTOR allouées par l’appelant . Un appel ultérieur à l’une de ces méthodes invalide le descripteur émis précédemment pour la mémoire tampon de réception ou la mémoire tampon de transmission, respectivement. L’appelant ne doit pas accéder à une mémoire tampon décrite par un descripteur de mémoire tampon qui n’est plus valide.

Les mémoires tampons obtenues par des appels successifs à SerCxRetrieveReceiveBuffer ou SerCxRetrieveTransmitBuffer ne sont pas garantis comme contiguës.

Le pilote de contrôleur doit appeler la fonction SERCX_BUFFER_DESCRIPTOR_INIT pour initialiser une structure SERCX_BUFFER_DESCRIPTOR avant que la structure ne soit transmise à la méthode SerCxRetrieveReceiveBuffer ou SerCxRetrieveTransmitBuffer . Une fois qu’un descripteur de mémoire tampon est initialisé, il peut être réutilisé sans être initialisé à nouveau.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge à partir de Windows 8.
En-tête	sercx.h

Voir aussi

SERCX_BUFFER_DESCRIPTOR_INIT

SerCxRetrieveReceiveBuffer

SerCxRetrieveTransmitBuffer