Метод ID3DXFileData::Lock

Обращается к данным X-файла.

Синтаксис

HRESULT Lock(
  [in]       SIZE_T *pSize,
  [in] const VOID   **ppData
);

Параметры

pSize [in]

Тип: SIZE_T*

Указатель на размер данных X-файла.

ppData [in]

Тип: const VOID**

Адрес указателя для получения указателя интерфейса объекта данных файла ID3DXFileData . См. заметки.

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

Тип: HRESULT

Если метод выполнен успешно, возвращаемое значение будет S_OK. Если метод завершается ошибкой, возвращается следующее значение: D3DXFERR_BADVALUE.

Комментарии

Указатель ppData действителен только во время ID3DXFileData::Lock ... ID3DXFileData::Unlock sequence. Можно выполнить несколько вызовов блокировки. Однако необходимо убедиться, что количество вызовов блокировки совпадает с числом вызовов разблокировки.

Так как данные файла не гарантируют правильное согласование с границами байтов, доступ к ppData следует получить с помощью указателей UNALIGNED.

Возвращаемые значения параметров не гарантированно являются допустимыми из-за возможного повреждения файла; Поэтому код должен проверять возвращаемые значения параметров.

Требования

Требование Значение
Заголовок
D3DX9Xof.h
Библиотека
D3dx9.lib

См. также раздел

ID3DXFileData