GetRawInputBuffer-Funktion (winuser.h)

Führt einen gepufferten Lesevorgang der unformatierten Eingabenachrichtendaten aus, die in der Nachrichtenwarteschlange des aufrufenden Threads enthalten sind.

Syntax

UINT GetRawInputBuffer(
  [out, optional] PRAWINPUT pData,
  [in, out]       PUINT     pcbSize,
  [in]            UINT      cbSizeHeader
);

Die Parameter

[out, optional] pData

Typ: PRAWINPUT

Ein Zeiger auf einen Puffer von RAWINPUT-Strukturen , die die rohen Eingabedaten enthalten. Der Zeiger sollte an einer DWORD-Grenze (32-Bit) ausgerichtet werden.

Wenn NULL, wird die Größe der ersten rohen Eingabemeldungsdaten (minimaler erforderlicher Puffer) in Bytes in *pcbSize zurückgegeben.

[in, out] pcbSize

Typ: PUINT

Die Größe des bereitgestellten RAWINPUT-Puffers in Bytes.

[in] cbSizeHeader

Typ: UINT-

Die Größe der RAWINPUTHEADER-Struktur in Bytes.

Rückgabewert

Typ: UINT-

Wenn pDataNULL ist und die Funktion erfolgreich ist, ist der Rückgabewert null. Wenn pData nicht NULL ist und die Funktion erfolgreich ist, ist der Rückgabewert die Anzahl der RAWINPUT-Strukturen , die in pData geschrieben wurden.

Wenn ein Fehler auftritt, lautet der Rückgabewert (UINT)-1. Rufen Sie GetLastError für den Fehlercode auf.

Bemerkungen

Wenn eine Anwendung unformatierte Eingaben empfängt, erhält ihre Nachrichtenwarteschlange eine WM_INPUT Nachricht, und das Warteschlangenstatusflagge QS_RAWINPUT festgelegt ist.

Mit GetRawInputBuffer werden die rohen Eingabedaten im Array von RAWINPUT-Strukturen mit variabler Größe gelesen, und die entsprechenden WM_INPUT Nachrichten werden aus der Nachrichtenwarteschlange des aufrufenden Threads entfernt. Sie können diese Methode mehrmals mit Puffer aufrufen, der nicht in alle Nachrichtendaten passt, bis alle unformatierten Eingabemeldungen gelesen wurden.

Das NEXTRAWINPUTBLOCK-Makro ermöglicht es einer Anwendung, ein Array von RAWINPUT-Strukturen zu durchlaufen.

Wenn alle unformatierten Eingabemeldungen erfolgreich aus der Nachrichtenwarteschlange gelesen wurden, wird QS_RAWINPUT Flag aus dem Status der Nachrichtenwarteschlange des Anrufthreads gelöscht.

[StructLayout(LayoutKind.Explicit)]
internal struct RAWINPUT
{
    [FieldOffset(0)]
    public RAWINPUTHEADER header;

    [FieldOffset(16+8)]
    public RAWMOUSE mouse;

    [FieldOffset(16+8)]
    public RAWKEYBOARD keyboard;

    [FieldOffset(16+8)]
    public RAWHID hid;
}

Anforderungen

Siehe auch

Konzeptionelle

GetMessage-

NEXTRAWINPUTBLOCK

RAWINPUT

RAWINPUTHEADER

raw Input

Referenz

Übersicht über die Roheingabe