MSGQUEUEINFO

9/8/2008

Essa estrutura contém informações sobre um fila de mensagens.

Syntax

typedef MSGQUEUEINFO{
  DWORD dwSize;
  DWORD dwFlags;
  DWORD dwMaxMessages;
  DWORD cbMaxMessage;
  DWORD dwCurrentMessages;
  DWORD dwMaxQueueMessages;
  WORD wNumReaders;
  WORD wNumWriters;
} MSGQUEUEINFO, *PMSGQUEUEINFO, FAR* LPMSGQUEUEINFO;

Os membros

• dwSize
  Tamanho da reserva passado, maior que sizeof(MSGQUEUEINFO).

• dwFlags
  Valor especificado em MSGQUEUEOPTIONS.dwFlags passado quando o fila de mensagens é criado. Descreve o comportamento da fila de mensagens. Definido como MSGQUEUE_NOPRECOMMIT alocar mensagem buffers por demanda e a livre os buffers mensagem depois que eles estiverem ler, ou definir como MSGQUEUE_ALLOW_BROKEN para habilitar um ler ou operação de gravação para completo mesmo se não houver nenhum correspondente gravador ou leitor presente.

• dwMaxMessages
  Número máximo de mensagens permitidas na fila, se ele for zero, nenhuma restrição sobre o número de mensagens.

• cbMaxMessage
  Comprimento da mensagem em bytes.

• dwCurrentMessages
  Número de mensagens atualmente existentes na fila.

• dwMaxQueueMessages
  Número máximo de mensagens que já foram na fila em um tempo.

• wNumReaders
  Número de leitores anexado para a fila para leitura.

• wNumWriters
  Número de gravadores anexado para a fila para gravação.

Remarks

Se dwMaxMessages está definido para zero, existem há restrições sobre o número de mensagens na fila. Isso permite que o mesmo comportamento configuração implicitamente MSGQUEUE_NOPRECOMMIT in dwFlags.

Se o sinalizador MSGQUEUE_ALLOW_BROKEN não for especificado e houver, supondo que uma única ler e gravador, tanto a ler ou gravação a fila será excluída da memória e somente o aberto identificador para a fila existirá. É a opção Somente neste apontar para fechar o aberto restante identificador e reabrir a fila se necessário.

Requirements

Header	msgqueue.h
Windows Embedded CE	Windows CE .NET 4.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

Message Queue Point-to-Point Structures
CloseMsgQueue
CreateMsgQueue
GetMsgQueueInfo
MSGQUEUEOPTIONS
OpenMsgQueue
ReadMsgQueue
WriteMsgQueue

Other Resources

Message Queue Point-to-Point