Функция GetRawInputBuffer (winuser.h)

Выполняет буферизованное чтение необработанных входных сообщений, найденных в очереди сообщений вызывающего потока.

Синтаксис

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

Параметры

[out, optional] pData

Тип: PRAWINPUT

Указатель на буфер структур RAWINPUT , содержащих необработанные входные данные. Указатель должен быть выровнен на границе DWORD (32-разрядная версия).

Если значение NULL, размер первого необработанного входного сообщения (минимальный обязательный буфер) в байтах возвращается в *pcbSize.

[in, out] pcbSize

Тип: PUINT

Размер в байтах предоставленного буфера RAWINPUT .

[in] cbSizeHeader

Тип: UINT

Размер структуры RAWINPUTHEADER в байтах.

Возвращаемое значение

Тип: UINT

Если значение pData равно NULL , а функция выполнена успешно, возвращаемое значение равно нулю. Если pData не равно NULL и функция выполнена успешно, возвращаемое значение является числом структур RAWINPUT , записанных в pData.

Если возникает ошибка, возвращаемое значение равно (UINT)-1. Вызовите GetLastError для кода ошибки.

Замечания

Когда приложение получает необработанные входные данные, очередь сообщений получает сообщение WM_INPUT и задается флаг состояния очереди QS_RAWINPUT .

Используя GetRawInputBuffer, необработанные входные данные считываются в массиве структур RAWINPUT размера переменной и соответствующие сообщения WM_INPUT удаляются из очереди сообщений вызывающего потока. Этот метод можно вызывать несколько раз с буфером, который не может соответствовать всем данным сообщения до тех пор, пока не будут прочитаны все необработанные входные сообщения.

Макрос NEXTRAWINPUTBLOCK позволяет приложению проходить по массиву структур RAWINPUT .

Если все необработанные входные сообщения успешно считываются из очереди сообщений, QS_RAWINPUT флаг очищается от состояния очереди сообщений вызывающего потока.

[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;
}

Требования

См. также

Концептуальный

GetMessage

NEXTRAWINPUTBLOCK

RAWINPUT

RAWINPUTHEADER

необработанные входные

Справочные материалы

Обзор необработанных входных данных