Estrutura WSAPOLLFD (winsock2.h)

A estrutura WSAPOLLFD armazena informações de soquete usadas pela função WSAPoll .

Sintaxe

typedef struct pollfd {
  SOCKET fd;
  SHORT  events;
  SHORT  revents;
} WSAPOLLFD, *PWSAPOLLFD, *LPWSAPOLLFD;

Membros

fd

Tipo: SOCKET

O identificador do soquete para o qual encontrar status. Esse parâmetro será ignorado se definido como um valor negativo. Consulte Observações.

events

Tipo: short

Um conjunto de sinalizadores que indica o tipo de status sendo solicitado. Isso deve ser um ou mais dos itens a seguir.

Sinalizador Significado
POLLPRI Os dados prioritários podem ser lidos sem bloqueio. Esse sinalizador não é compatível com o provedor do Microsoft Winsock.
POLLRDBAND Os dados de banda prioritária (fora de banda) podem ser lidos sem bloqueio.
POLLRDNORM Dados normais podem ser lidos sem bloqueio.
POLLWRNORM Dados normais podem ser gravados sem bloqueio.
 

O sinalizador POLLIN é definido como a combinação dos valores de sinalizador POLLRDNORM e POLLRDBAND . O sinalizador POLLOUT é definido como o mesmo que o valor do sinalizador POLLWRNORM .

revents

Tipo: short

Um conjunto de sinalizadores que indicam, após o retorno da chamada da função WSAPoll, os resultados da consulta status. Isso pode ser uma combinação dos sinalizadores a seguir.

Sinalizador Descrição
POLLERR Ocorreu um erro.
POLLHUP Uma conexão orientada a fluxo foi desconectada ou anulada.
POLLNVAL Um soquete inválido foi usado.
POLLPRI Os dados prioritários podem ser lidos sem bloqueio. Esse sinalizador não é retornado pelo provedor do Microsoft Winsock.
POLLRDBAND Os dados de banda prioritária (fora de banda) podem ser lidos sem bloqueio.
POLLRDNORM Os dados normais podem ser lidos sem bloqueio.
POLLWRNORM Dados normais podem ser gravados sem bloqueio.
 

O sinalizador POLLIN é definido como a combinação dos valores de sinalizador POLLRDNORM e POLLRDBAND . O sinalizador POLLOUT é definido como o mesmo que o valor do sinalizador POLLWRNORM .

Para soquetes que não atendem à consulta status e não têm nenhum erro, o membro revents é definido como zero no retorno.

Comentários

A estrutura WSAPOLLFD é definida no Windows Vista e posterior.

A estrutura WSAPOLLFD é usada pela função WSAPoll para determinar o status de um ou mais soquetes. O conjunto de soquetes para o qual status é solicitado é especificado no parâmetro fdarray, que é uma matriz de estruturas WSAPOLLFD. Um aplicativo define os sinalizadores apropriados no membro de eventos da estrutura WSAPOLLFD para especificar o tipo de status solicitado para cada soquete correspondente. A função WSAPoll retorna o status de um soquete no membro revents da estrutura WSAPOLLFD.

Se o membro fd da estrutura WSAPOLLFD for definido como um valor negativo, a estrutura será ignorada pela chamada de função WSAPoll e o membro revents será limpo após o retorno. Isso é útil para aplicativos que mantêm uma alocação fixa para o parâmetro fdarray de WSAPoll; esses aplicativos não precisam desperdiçar recursos compactando elementos da matriz para entradas não usadas ou realocando memória. É desnecessário limpar o membro revents antes de chamar a função WSAPoll .

Requisitos

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

Confira também

WSAPoll

accept

connect

Recv