estrutura TRANSMIT_PACKETS_ELEMENT (mswsock.h)

  • Artigo

A estrutura TRANSMIT_PACKETS_ELEMENT especifica um único elemento de dados a ser transmitido pela função TransmitPackets .

Sintaxe

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;

Membros

dwElFlags

Tipo: ULONG

Sinalizadores usados para descrever o conteúdo do elemento de matriz de pacotes e personalizar o processamento da função TransmitPackets . A tabela a seguir lista os sinalizadores válidos:

Sinalizador Significado
TP_ELEMENT_FILE
 Especifica que os dados residem em um arquivo. Configuração padrão para dwElFlags. Mutuamente exclusivo com TP_ELEMENT_MEMORY.
TP_ELEMENT_MEMORY
 Especifica que os dados residem na memória. Mutuamente exclusivo com TP_ELEMENT_FILE.
TP_ELEMENT_EOP
 Especifica que esse elemento não deve ser combinado com o próximo elemento em uma única solicitação de envio da camada de soquetes para o transporte. Este sinalizador é usado para controle granular do conteúdo de cada mensagem em um diagrama ou soquete orientado a mensagens.

cLength

Tipo: ULONG

O número de bytes a serem transmitidos. Se zero, todo o arquivo será transmitido.

nFileOffset

Tipo: LARGE_INTEGER

O deslocamento de arquivo, em bytes, no qual iniciar a transferência. Válido somente se TP_ELEMENT_FILE for especificado em dwEIFlags. Quando definido como –1, a transmissão começa no deslocamento de bytes atual.

hFile

Tipo: HANDLE

Um identificador para um arquivo aberto a ser transmitido. Válido somente se TP_ELEMENT_FILE for especificado em dwEIFlags. O Windows lê o arquivo sequencialmente; O desempenho do cache é aprimorado abrindo esse identificador com FILE_FLAG_SEQUENTIAL_SCAN.

pBuffer

Tipo: PVOID

Um ponteiro para os dados na memória a serem enviados. Válido somente se TP_ELEMENT_MEMORY for especificado em dwEIFlags.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho mswsock.h

Confira também

TransmitPackets

LPFN_WSARECVMSG (WSARecvMsg)

send