структура D3D11_MAPPED_SUBRESOURCE (d3d11.h)

Предоставляет доступ к данным подресурса.

Синтаксис

typedef struct D3D11_MAPPED_SUBRESOURCE {
  void *pData;
  UINT RowPitch;
  UINT DepthPitch;
} D3D11_MAPPED_SUBRESOURCE;

Члены

pData

Тип: void*

Указатель на данные. Когда ID3D11DeviceContext::Map предоставляет указатель, среда выполнения гарантирует, что указатель имеет определенное выравнивание в зависимости от следующих уровней функций:

RowPitch

Тип: UINT

Шаг строки, ширина или физический размер (в байтах) данных.

DepthPitch

Тип: UINT

Шаг глубины, ширина или физический размер (в байтах) данных.

Комментарии

Эта структура используется в вызове ID3D11DeviceContext::Map.

Значения в этих элементах сообщают, сколько данных можно просмотреть:

  • pData указывает на строку 0 и срез глубины 0.
  • RowPitch содержит значение, которое среда выполнения добавляет в pData для перемещения из строки в строку, где каждая строка содержит несколько пикселей.
  • DepthPitch содержит значение, добавляемое средой выполнения в pData для перемещения от среза глубины к срезу глубины, где каждый срез глубины содержит несколько строк.
Если RowPitch и DepthPitch не подходят для типа ресурса, среда выполнения может задать для них значение 0. Поэтому не используйте эти значения только для перебора строк и глубины. Ниже приведено несколько примеров.
  • Для Buffer и Texture1D среда выполнения присваивает rowPitch и DepthPitch значения, которые не являются 0. Например, если буфер содержит 8 байт, среда выполнения присваивает RowPitch и DepthPitch значения, которые больше или равны 8.
  • Для Texture2D среда выполнения по-прежнему присваивает DepthPitch значение, которое не равно 0, при условии, что поле не используется.
Примечание Среда выполнения может назначать значения RowPitch и DepthPitch , которые больше, чем ожидалось, так как между строками и глубиной может быть заполнение.
 

Требования

Требование Значение
Заголовок d3d11.h

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

Структуры ресурсов