TRANSMIT_PACKETS_ELEMENT-Struktur (mswsock.h)

  • Artikel

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
TP_ELEMENT_FILE
 Gibt an, dass sich Daten in einer Datei befinden. Standardeinstellung für dwElFlags. Schließen Sie sich mit TP_ELEMENT_MEMORY gegenseitig aus.
TP_ELEMENT_MEMORY
 Gibt an, dass sich Die Daten im Arbeitsspeicher befinden. Schließen Sie sich mit TP_ELEMENT_FILE gegenseitig aus.
TP_ELEMENT_EOP
 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

TransmitPackets

LPFN_WSARECVMSG (WSARecvMsg)

send