Шаг 10 - Определяем формат данных - SetDataFormat

После того как установлен уровень кооперации, обязательно нужно установить формат данных. Смысл установки формата данных в том, чтобы указать какие части устройства (например кнопки мыши) будут использоваться. Для вызова этой функции используется структура описывающая необходимый формат. Но для стандартных устройств нет необходимости заполнять эту довольно сложную структуру, можно воспользоваться типовыми форматами. В VB есть упрощенная функция SetCommonDataFormat. Итак, смотрим описание.

Visual Basic
Visual C++

Visual Basic

object.SetDataFormat(format As DIDATAFORMAT, formatArray() As DIOBJECTDATAFORMAT))

Параметры
object
Объектная переменная типа DirectInputDevice
format
Описывает формат данных который должны вернуться
formatArray
Массив DIOBJECTDATAFORMAT описывающих формат данных на устройстве.

Ошибки
Если вызов успешен, то будет сгенерирована ошибка и код установлен в Err.Number в одно из следующих значений:

DIERR_ACQUIRED  
DIERR_INVALIDPARAM  

Visual C++

HRESULT SetDataFormat
(
	LPCDIDATAFORMAT lpdf
);

Параметры
lpdf
Адрес структуры DIDATAFORMAT описывающей требуемый формат данных.

Возвращаемое значение.
Если вызов успешный функция возвращает DI_OK. Иначе один из следующих кодов ошибки.

DIERR_ACQUIRED  
DIERR_INVALIDPARAM  
DIERR_NOTINITIALIZED  

Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Каев Артем - 3.06.2002