Compartilhar via


MSGQUEUEINFO

Windows Mobile SupportedWindows Embedded CE Supported

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