TRANSMIT_PACKETS_ELEMENT structure (mswsock.h)

Article
02/29/2024

La structure TRANSMIT_PACKETS_ELEMENT spécifie un seul élément de données à transmettre par la fonction TransmitPackets .

Syntaxe

typedef struct _TRANSMIT_PACKETS_ELEMENT {
  ULONG dwElFlags;
  ULONG cLength;
  union {
    struct {
      LARGE_INTEGER nFileOffset;
      HANDLE        hFile;
    };
    PVOID pBuffer;
  };
} TRANSMIT_PACKETS_ELEMENT, *PTRANSMIT_PACKETS_ELEMENT, *LPTRANSMIT_PACKETS_ELEMENT;

Membres

dwElFlags

Type : ULONG

Indicateurs utilisés pour décrire le contenu de l’élément de tableau de paquets et personnaliser le traitement de la fonction TransmitPackets . Le tableau suivant répertorie les indicateurs valides :

Indicateur	Signification
TP_ELEMENT_FILE	Spécifie que les données résident dans un fichier. Paramètre par défaut pour dwElFlags. Mutuellement exclusif avec TP_ELEMENT_MEMORY.
TP_ELEMENT_MEMORY	Spécifie que les données résident en mémoire. Mutuellement exclusif avec TP_ELEMENT_FILE.
TP_ELEMENT_EOP	Spécifie que cet élément ne doit pas être combiné avec l’élément suivant dans une demande d’envoi unique de la couche sockets vers le transport. Cet indicateur est utilisé pour le contrôle précis du contenu de chaque message sur un datagramme ou un socket orienté message.

cLength

Type : ULONG

Nombre d’octets à transmettre. Si zéro, le fichier entier est transmis.

nFileOffset

Type : LARGE_INTEGER

Décalage de fichier, en octets, auquel commencer le transfert. Valide uniquement si TP_ELEMENT_FILE est spécifié dans dwEIFlags. Lorsque la valeur est –1, la transmission commence au décalage d’octet actuel.

hFile

Type : HANDLE

Handle à un fichier ouvert à transmettre. Valide uniquement si TP_ELEMENT_FILE est spécifié dans dwEIFlags. Windows lit le fichier de manière séquentielle ; Les performances de mise en cache sont améliorées en ouvrant ce handle avec FILE_FLAG_SEQUENTIAL_SCAN.

pBuffer

Type : PVOID

Pointeur vers les données en mémoire à envoyer. Valide uniquement si TP_ELEMENT_MEMORY est spécifié dans dwEIFlags.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	mswsock.h

Voir aussi

TransmitPackets

LPFN_WSARECVMSG (WSARecvMsg)

envoyer

Share via