Nachrichten und Nachrichtenwarteschlangen

  • Artikel

In diesem Abschnitt werden Nachrichten und Nachrichtenwarteschlangen und deren Verwendung in Ihren Anwendungen beschrieben.

In diesem Abschnitt

Name BESCHREIBUNG
Informationen zu Meldungen und Meldungswarteschlangen In diesem Abschnitt werden Windows-Nachrichten und -Nachrichtenwarteschlangen erläutert.
Verwenden von Nachrichten und Nachrichtenwarteschlangen Die folgenden Codebeispiele veranschaulichen, wie die folgenden Aufgaben ausgeführt werden, die Windows-Nachrichten und -Nachrichtenwarteschlangen zugeordnet sind.
Nachrichtenreferenz Enthält den API-Verweis.

System-Provided Nachrichten

Listen der vom System bereitgestellten Nachrichten finden Sie unter Systemdefinierte Nachrichten.

Nachrichtenfunktionen

Name BESCHREIBUNG
BroadcastSystemMessage Sendet eine Nachricht an die angegebenen Empfänger. Die Empfänger können Anwendungen, installierbare Treiber, Netzwerktreiber, Gerätetreiber auf Systemebene oder eine beliebige Kombination dieser Systemkomponenten sein.
Um zusätzliche Informationen zu erhalten, wenn die Anforderung definiert ist, verwenden Sie die BroadcastSystemMessageEx-Funktion .
BroadcastSystemMessageEx Sendet eine Nachricht an die angegebenen Empfänger. Die Empfänger können Anwendungen, installierbare Treiber, Netzwerktreiber, Gerätetreiber auf Systemebene oder eine beliebige Kombination dieser Systemkomponenten sein.
Diese Funktion ähnelt BroadcastSystemMessage , mit der Ausnahme, dass diese Funktion weitere Informationen von den Empfängern zurückgeben kann.
DispatchMessage Sendet eine Nachricht an eine Fensterprozedur. Es wird in der Regel verwendet, um eine Nachricht zu senden, die von der GetMessage-Funktion abgerufen wird.
GetInputState Bestimmt, ob in der Nachrichtenwarteschlange des aufrufenden Threads Maus- oder Tastaturnachrichten vorhanden sind.
GetMessage Ruft eine Nachricht aus der Nachrichtenwarteschlange des aufrufenden Threads ab. Die Funktion sendet eingehende gesendete Nachrichten, bis eine gesendete Nachricht für den Abruf verfügbar ist.
Im Gegensatz zu GetMessage wartet die PeekMessage-Funktion nicht, bis eine Nachricht gesendet wird, bevor sie zurückgegeben wird.
GetMessageExtraInfo Ruft die zusätzlichen Nachrichteninformationen für den aktuellen Thread ab. Zusätzliche Nachrichteninformationen sind ein anwendungs- oder treiberdefinierter Wert, der der Nachrichtenwarteschlange des aktuellen Threads zugeordnet ist.
GetMessagePos Ruft die Cursorposition für die letzte Nachricht ab, die von der GetMessage-Funktion abgerufen wurde.
Um die aktuelle Position des Cursors zu bestimmen, verwenden Sie die GetCursorPos-Funktion .
GetMessageTime Ruft die Nachrichtenzeit für die letzte Nachricht ab, die von der GetMessage-Funktion abgerufen wurde. Die Zeit ist eine lange ganze Zahl, die die verstrichene Zeit in Millisekunden vom Start des Systems bis zum Zeitpunkt der Erstellung der Nachricht (d. h. in der Nachrichtenwarteschlange des Threads) angibt.
GetQueueStatus Gibt den Typ der Nachrichten an, die in der Nachrichtenwarteschlange des aufrufenden Threads gefunden wurden.
InSendMessage Bestimmt, ob die aktuelle Fensterprozedur eine Nachricht verarbeitet, die von einem anderen Thread (im selben Prozess oder einem anderen Prozess) durch einen Aufruf der SendMessage-Funktion gesendet wurde.
Verwenden Sie die Funktion InSendMessageEx , um zusätzliche Informationen darüber zu erhalten, wie die Nachricht gesendet wurde.
InSendMessageEx Bestimmt, ob die aktuelle Fensterprozedur eine Nachricht verarbeitet, die von einem anderen Thread (im selben Prozess oder in einem anderen Prozess) gesendet wurde.
PeekMessage Sendet eingehende gesendete Nachrichten, überprüft die Threadnachrichtenwarteschlange auf eine gesendete Nachricht und ruft die Nachricht ab (falls vorhanden).
PostMessage Sendet eine Nachricht in der Nachrichtenwarteschlange, die dem Thread zugeordnet ist, der das angegebene Fenster erstellt hat, und gibt zurück, ohne darauf zu warten, dass der Thread die Nachricht verarbeitet.
Um eine Nachricht in der Nachrichtenwarteschlange zu posten, die einem Thread zugeordnet ist, verwenden Sie die PostThreadMessage-Funktion .
PostQuitMessage Gibt dem System an, dass ein Thread eine Anforderung zum Beenden (Beenden) gestellt hat. Sie wird in der Regel als Reaktion auf eine WM_DESTROY-Nachricht verwendet.
PostThreadMessage Sendet eine Nachricht an die Nachrichtenwarteschlange des angegebenen Threads. Es wird zurückgegeben, ohne darauf zu warten, dass der Thread die Nachricht verarbeitet.
RegisterWindowMessage Definiert eine neue Fenstermeldung, die garantiert im gesamten System eindeutig ist. Der Nachrichtenwert kann beim Senden oder Posten von Nachrichten verwendet werden.
ReplyMessage Antwortet auf eine Nachricht, die über die SendMessage-Funktion gesendet wird, ohne die Steuerung an die Funktion zurückzugeben, die SendMessage aufgerufen hat.
SendAsyncProc Eine anwendungsdefinierte Rückruffunktion, die mit der SendMessageCallback-Funktion verwendet wird. Das System übergibt die Nachricht an die Rückruffunktion, nachdem die Nachricht an die Zielfensterprozedur übergeben wurde. Der SENDASYNCPROC-Typ definiert einen Zeiger auf diese Rückruffunktion. SendAsyncProc ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.
SendMessage Sendet die angegebene Nachricht an ein Fenster oder Fenster. Die SendMessage-Funktion ruft die Fensterprozedur für das angegebene Fenster auf und wird erst zurückgegeben, wenn die Fensterprozedur die Nachricht verarbeitet hat.
Um eine Nachricht zu senden und sofort zurückzugeben, verwenden Sie die Funktion SendMessageCallback oder SendNotifyMessage . Um eine Nachricht in der Nachrichtenwarteschlange eines Threads zu posten und sofort zurückzugeben, verwenden Sie die Funktion PostMessage oder PostThreadMessage .
SendMessageCallback Sendet die angegebene Nachricht an ein Fenster oder Fenster. Es ruft die Fensterprozedur für das angegebene Fenster auf und gibt sofort zurück. Nachdem die Fensterprozedur die Nachricht verarbeitet hat, ruft das System die angegebene Rückruffunktion auf und übergibt das Ergebnis der Nachrichtenverarbeitung und einen von der Anwendung definierten Wert an die Rückruffunktion.
SendMessageTimeout Sendet die angegebene Nachricht an eines von mehreren Fenstern.
SendNotifyMessage Sendet die angegebene Nachricht an ein Fenster oder Fenster. Wenn das Fenster vom aufrufenden Thread erstellt wurde, ruft SendNotifyMessage die Fensterprozedur für das Fenster auf und wird erst zurückgegeben, wenn die Fensterprozedur die Nachricht verarbeitet hat. Wenn das Fenster von einem anderen Thread erstellt wurde, übergibt SendNotifyMessage die Nachricht an die Fensterprozedur und gibt sofort zurück. Es wartet nicht, bis die Fensterprozedur die Verarbeitung der Nachricht abgeschlossen hat.
SetMessageExtraInfo Legt die zusätzlichen Nachrichteninformationen für den aktuellen Thread fest. Zusätzliche Nachrichteninformationen sind ein anwendungs- oder treiberdefinierter Wert, der der Nachrichtenwarteschlange des aktuellen Threads zugeordnet ist. Eine Anwendung kann die GetMessageExtraInfo-Funktion verwenden, um die zusätzlichen Nachrichteninformationen eines Threads abzurufen.
TranslateMessage Übersetzt Nachrichten mit virtuellen Schlüsseln in Zeichennachrichten. Die Zeichennachrichten werden an die Nachrichtenwarteschlange des aufrufenden Threads gesendet, um beim nächsten Aufruf der GetMessage - oder PeekMessage-Funktion vom Thread gelesen zu werden.
WaitMessage Gibt die Steuerung für andere Threads ab, wenn ein Thread keine anderen Nachrichten in seiner Nachrichtenwarteschlange enthält. Die WaitMessage-Funktion hält den Thread an und gibt erst zurück, wenn eine neue Nachricht in der Nachrichtenwarteschlange des Threads platziert wird.

Nachrichtenkonstanten

Name BESCHREIBUNG
OCM__BASE Wird verwendet, um private Nachrichten für die Verwendung durch private Fensterklassen zu definieren.
WM_APP Wird verwendet, um private Nachrichten zu definieren.
WM_USER Wird verwendet, um private Nachrichten für die Verwendung durch private Fensterklassen zu definieren.

Nachrichtenstrukturen

Name BESCHREIBUNG
BSMINFO Enthält Informationen zu einem Fenster, das eine Anforderung von BroadcastSystemMessageEx abgelehnt hat.
MSG Enthält Meldungsinformationen aus der Meldungswarteschlange eines Threads.