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
 ソケット レイヤーからトランスポートへの 1 回の 送信 要求で、この要素を次の要素と組み合わせないように指定します。 このフラグは、データグラム ソケットまたはメッセージ指向のソケット上の各メッセージ内容を詳細に制御するために使用されます。

cLength

種類: ULONG

送信するバイト数。 0 の場合、ファイル全体が送信されます。

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 (デスクトップ アプリのみ)
Header mswsock.h

こちらもご覧ください

TransmitPackets

LPFN_WSARECVMSG (WSARecvMsg)

送信