Estructura WSAPOLLFD (winsock2.h)

  • Artículo

La estructura WSAPOLLFD almacena la información de socket utilizada por la función WSAPoll .

Sintaxis

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

Miembros

fd

Tipo: SOCKET

Identificador del socket para el que se va a buscar el estado. Este parámetro se omite si se establece en un valor negativo. Vea la sección Comentarios.

events

Tipo: short

Un conjunto de marcas que indica el tipo de estado que se solicita. Debe ser uno o varios de los siguientes.

Marca Significado
POLLPRI Los datos de prioridad se pueden leer sin bloqueo. Este indicador no es compatible con el proveedor de Microsoft Winsock.
POLLRDBAND Los datos de banda de prioridad (fuera de banda) se pueden leer sin bloqueo.
POLLRDNORM Los datos normales se pueden leer sin bloqueo.
POLLWRNORM Los datos normales se pueden escribir sin bloqueo.
 

La marca POLLIN se define como la combinación de los valores de marca POLLRDNORM y POLLRDBAND . La marca POLLOUT se define como la misma que el valor de la marca POLLWRNORM .

revents

Tipo: short

Un conjunto de marcas que indican, al devolver desde la llamada de función WSAPoll , los resultados de la consulta de estado. Esto puede ser una combinación de las marcas siguientes.

Marca Descripción
POLLERR Se ha producido un error.
POLLHUP Una conexión orientada a secuencias se desconecta o anula.
POLLNVAL Se usó un socket no válido.
POLLPRI Los datos de prioridad se pueden leer sin bloqueo. El proveedor de Microsoft Winsock no devuelve esta marca.
POLLRDBAND Los datos de banda de prioridad (fuera de banda) se pueden leer sin bloquear.
POLLRDNORM Los datos normales se pueden leer sin bloqueo.
POLLWRNORM Los datos normales se pueden escribir sin bloqueo.
 

La marca POLLIN se define como la combinación de los valores de marca POLLRDNORM y POLLRDBAND . La marca POLLOUT se define como la misma que el valor de la marca POLLWRNORM .

En el caso de los sockets que no satisfacen la consulta de estado y no tienen ningún error, el miembro revents se establece en cero tras la devolución.

Comentarios

La estructura WSAPOLLFD se define en Windows Vista y versiones posteriores.

La estructura WSAPOLLFD la usa la función WSAPoll para determinar el estado de uno o varios sockets. El conjunto de sockets para los que se solicita el estado se especifica en el parámetro fdarray , que es una matriz de estructuras WSAPOLLFD . Una aplicación establece las marcas adecuadas en el miembro de eventos de la estructura WSAPOLLFD para especificar el tipo de estado solicitado para cada socket correspondiente. La función WSAPoll devuelve el estado de un socket en el miembro revents de la estructura WSAPOLLFD .

Si el miembro fd de la estructura WSAPOLLFD se establece en un valor negativo, la llamada a la función WSAPoll omite la estructura y el miembro revents se borra al devolver. Esto es útil para las aplicaciones que mantienen una asignación fija para el parámetro fdarray de WSAPoll; estas aplicaciones no necesitan desperdiciar recursos compactando elementos de la matriz para entradas sin usar ni reasignar memoria. No es necesario borrar el miembro revents antes de llamar a la función WSAPoll .

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado winsock2.h

Consulte también

WSAPoll

accept

connect

recv