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.

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.

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

Confira também

WSAPoll

accept

connect

Recv