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 |