TRANSMIT_PACKETS_ELEMENT 結構 (mswsock.h)

TRANSMIT_PACKETS_ELEMENT 結構會指定要由 TransmitPackets 函式傳輸的單一數據元素。

語法

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;

成員

dwElFlags

類型： ULONG

用來描述封包陣列項目內容的旗標，以及自定義 TransmitPackets 函式處理。 下表列出有效的旗標：

旗標	意義
TP_ELEMENT_FILE	指定數據位於檔案中。 dwElFlags 的預設設定。 與TP_ELEMENT_MEMORY互斥。
TP_ELEMENT_MEMORY	指定數據位於記憶體中。 與TP_ELEMENT_FILE互斥。
TP_ELEMENT_EOP	指定此專案不應與單一 傳送 要求中的下一個項目結合，從套接字層傳送至傳輸。 這個旗標可用來更精細地控制資料包上或訊息導向通訊端上每個訊息的內容。

cLength

類型： ULONG

要傳輸的位元組數目。 如果為零，則會傳輸整個檔案。

nFileOffset

類型： LARGE_INTEGER

要開始傳輸的檔案位移，以位元組為單位。 只有在 dwEIFlags 中指定TP_ELEMENT_FILE時才有效。 當設定為 –1 時，傳輸會從目前的位元組位移開始。

hFile

類型： HANDLE

要傳輸之開啟檔案的句柄。 只有在 dwEIFlags 中指定TP_ELEMENT_FILE時才有效。 Windows 會循序讀取檔案;使用 FILE_FLAG_SEQUENTIAL_SCAN開啟此句柄，可改善快取效能。

pBuffer

類型： PVOID

要傳送之內存中數據的指標。 只有在 dwEIFlags 中指定TP_ELEMENT_MEMORY時才有效。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
標頭	mswsock.h

另請參閱

TransmitPackets

LPFN_WSARECVMSG (WSARecvMsg)

send