estrutura TRANSMIT_PACKETS_ELEMENT (mswsock.h)
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 |
|---|---|
|
Especifica que os dados residem em um arquivo. Configuração padrão para dwElFlags. Mutuamente exclusivo com TP_ELEMENT_MEMORY. |
|
Especifica que os dados residem na memória. Mutuamente exclusivo com TP_ELEMENT_FILE. |
|
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
send