TRANSMIT_PACKETS_ELEMENT-Struktur (mswsock.h)
Die TRANSMIT_PACKETS_ELEMENT-Struktur gibt ein einzelnes Datenelement an, das von der TransmitPackets-Funktion übertragen werden soll.
Syntax
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;
Member
dwElFlags
Typ: ULONG
Flags, die verwendet werden, um den Inhalt des Paketarrayelements zu beschreiben und die Verarbeitung der TransmitPackets-Funktion anzupassen. In der folgenden Tabelle sind gültige Flags aufgeführt:
| Flag | Bedeutung |
|---|---|
|
Gibt an, dass sich Daten in einer Datei befinden. Standardeinstellung für dwElFlags. Schließen Sie sich mit TP_ELEMENT_MEMORY gegenseitig aus. |
|
Gibt an, dass sich Die Daten im Arbeitsspeicher befinden. Schließen Sie sich mit TP_ELEMENT_FILE gegenseitig aus. |
|
Gibt an, dass dieses Element nicht mit dem nächsten Element in einer einzelnen Sendeanforderung von der Socketebene an den Transport kombiniert werden soll. Dieses Flag wird zum genaueren Steuern des Inhalts der einzelnen Nachrichten bei einem datagramm- oder nachrichtenorientierten Socket verwendet. |
cLength
Typ: ULONG
Die Anzahl der zu übertragenden Bytes. Wenn null, wird die gesamte Datei übertragen.
nFileOffset
Typ: LARGE_INTEGER
Der Dateioffset in Bytes, an dem die Übertragung beginnen soll. Nur gültig, wenn TP_ELEMENT_FILE in dwEIFlags angegeben ist. Bei Festlegung auf –1 beginnt die Übertragung am aktuellen Byteoffset.
hFile
Typ: HANDLE
Ein Handle für eine geöffnete Datei, die übertragen werden soll. Nur gültig, wenn TP_ELEMENT_FILE in dwEIFlags angegeben ist. Windows liest die Datei sequenziell; Die Zwischenspeicherungsleistung wird verbessert, indem sie dieses Handle mit FILE_FLAG_SEQUENTIAL_SCAN öffnen.
pBuffer
Typ: PVOID
Ein Zeiger auf die daten im Arbeitsspeicher, die gesendet werden sollen. Nur gültig, wenn TP_ELEMENT_MEMORY in dwEIFlags angegeben ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Kopfzeile | mswsock.h |
Weitere Informationen
send