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 une opération 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 futures versions 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 où, en mémoire, lire les données pendant une opération de réception et où, en mémoire, écrire des données pendant une opération de transmission.
À tout moment, il ne peut y avoir plus d’une mémoire tampon de réception valide et une mémoire tampon de transmission valide. Le pilote du 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 les structures SERCX_BUFFER_DESCRIPTOR allouées par l’appelant. Un appel ultérieur à l’une de ces méthodes invalide respectivement le descripteur émis précédemment pour la mémoire tampon de réception ou la mémoire tampon de transmission. 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 garanties comme contiguës.
Le pilote du 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Prise en charge à partir de Windows 8. |
| d’en-tête | sercx.h |