struttura TRANSMIT_PACKETS_ELEMENT (mswsock.h)

Articolo
02/29/2024

La struttura TRANSMIT_PACKETS_ELEMENT specifica un singolo elemento dati da trasmettere dalla funzione TransmitPackets .

Sintassi

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;

Members

dwElFlags

Tipo: ULONG

Flag usati per descrivere il contenuto dell'elemento della matrice di pacchetti e per personalizzare l'elaborazione della funzione TransmitPackets . La tabella seguente elenca i flag validi:

Contrassegno	Significato
TP_ELEMENT_FILE	Specifica che i dati risiedono in un file. Impostazione predefinita per dwElFlags. Si escludono a vicenda con TP_ELEMENT_MEMORY.
TP_ELEMENT_MEMORY	Specifica che i dati risiedono in memoria. Si escludono a vicenda con TP_ELEMENT_FILE.
TP_ELEMENT_EOP	Specifica che questo elemento non deve essere combinato con l'elemento successivo in una singola richiesta di invio dal livello socket al trasporto. Questo flag viene utilizzato per il controllo granulare del contenuto di ogni messaggio su un socket di datagramma o orientato al messaggio.

cLength

Tipo: ULONG

Numero di byte da trasmettere. Se zero, viene trasmesso l'intero file.

nFileOffset

Tipo: LARGE_INTEGER

Offset del file, in byte, in corrispondenza del quale iniziare il trasferimento. Valido solo se TP_ELEMENT_FILE è specificato in dwEIFlags. Se impostato su -1, la trasmissione inizia con l'offset di byte corrente.

hFile

Tipo: HANDLE

Handle per un file aperto da trasmettere. Valido solo se TP_ELEMENT_FILE è specificato in dwEIFlags. Windows legge il file in sequenza; le prestazioni di memorizzazione nella cache sono migliorate aprendo questo handle con FILE_FLAG_SEQUENTIAL_SCAN.

pBuffer

Tipo: PVOID

Puntatore ai dati in memoria da inviare. Valido solo se TP_ELEMENT_MEMORY è specificato in dwEIFlags.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	mswsock.h

Vedi anche

TransmitPackets

LPFN_WSARECVMSG (WSARecvMsg)

send

Share via