Bagikan melalui

struktur TRANSMIT_PACKETS_ELEMENT (mswsock.h)

  • Artikel

Struktur TRANSMIT_PACKETS_ELEMENT menentukan satu elemen data yang akan ditransmisikan oleh fungsi TransmitPackets .

Sintaks

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;

Anggota

dwElFlags

Jenis: ULONG

Bendera yang digunakan untuk menjelaskan konten elemen array paket, dan untuk menyesuaikan pemrosesan fungsi TransmitPackets . Tabel berikut ini mencantumkan bendera yang valid:

Bendera Makna
TP_ELEMENT_FILE
 Menentukan bahwa data berada dalam file. Pengaturan default untuk dwElFlags. Saling eksklusif dengan TP_ELEMENT_MEMORY.
TP_ELEMENT_MEMORY
 Menentukan bahwa data berada dalam memori. Saling eksklusif dengan TP_ELEMENT_FILE.
TP_ELEMENT_EOP
 Menentukan bahwa elemen ini tidak boleh dikombinasikan dengan elemen berikutnya dalam satu permintaan pengiriman dari lapisan soket ke transportasi. Bendera ini digunakan untuk kontrol terperinci dari konten setiap pesan pada datagram atau soket berorientasi pesan.

cLength

Jenis: ULONG

Jumlah byte yang akan ditransmisikan. Jika nol, seluruh file ditransmisikan.

nFileOffset

Jenis: LARGE_INTEGER

Offset file, dalam byte, untuk memulai transfer. Hanya berlaku jika TP_ELEMENT_FILE ditentukan dalam dwEIFlags. Ketika diatur ke –1, transmisi dimulai pada offset byte saat ini.

hFile

Jenis: HANDEL

Handel ke file terbuka yang akan ditransmisikan. Hanya berlaku jika TP_ELEMENT_FILE ditentukan dalam dwEIFlags. Windows membaca file secara berurutan; Performa penembolokan ditingkatkan dengan membuka handel ini dengan FILE_FLAG_SEQUENTIAL_SCAN.

pBuffer

Jenis: PVOID

Penunjuk ke data dalam memori yang akan dikirim. Hanya berlaku jika TP_ELEMENT_MEMORY ditentukan dalam dwEIFlags.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Header mswsock.h

Lihat juga

TransmitPackets

LPFN_WSARECVMSG (WSARecvMsg)

Mengirim