Метод ID3D12Device::CreateUnorderedAccessView (d3d12.h)

Создает представление для неупорядоченного доступа.

Синтаксис

void CreateUnorderedAccessView(
       ID3D12Resource                         *pResource,
       ID3D12Resource                         *pCounterResource,
       const D3D12_UNORDERED_ACCESS_VIEW_DESC *pDesc,
  [in] D3D12_CPU_DESCRIPTOR_HANDLE            DestDescriptor
);

Параметры

pResource

Тип: [in, необязательно] ID3D12Resource*

Указатель на объект ID3D12Resource , представляющий неупорядоченный доступ.

Необходимо указать по крайней мере один из pResource или pDesc .

Пустой pResource используется для инициализации дескриптора NULL, который гарантирует поведение привязки null, подобное Direct3D 11 (при чтении 0, операции записи удаляются), но для определения типа дескриптора необходимо иметь допустимый pDesc .

pCounterResource

Тип: [in, необязательно] ID3D12Resource*

Идентификатор ID3D12Resource для счетчика (при наличии), связанного с БПЛА.

Если pCounterResource не указан, то элемент CounterOffsetInBytes структуры D3D12_BUFFER_UAV должен иметь значение 0.

Если указан параметр pCounterResource , то с UAV связан счетчик, и среда выполнения выполняет проверку следующих требований:

• Элемент StructureByteStride структуры D3D12_BUFFER_UAV должен быть больше 0.
• Формат должен быть DXGI_FORMAT_UNKNOWN.
• Флаг D3D12_BUFFER_UAV_FLAG_RAW (константа перечисления D3D12_BUFFER_UAV_FLAGS ) задавать нельзя.
• Оба ресурса (pResource и pCounterResource) должны быть буферами.
• Элемент CounterOffsetInBytes структуры D3D12_BUFFER_UAV должен быть кратным **D3D12_UAV_COUNTER_PLACEMENT_ALIGNMENT** (4096) и находиться в диапазоне ресурса счетчика.
• pResource не может иметь значение NULL
• pDesc не может иметь значение NULL.

pDesc

Тип: [in, необязательный] const D3D12_UNORDERED_ACCESS_VIEW_DESC*

Указатель на структуру D3D12_UNORDERED_ACCESS_VIEW_DESC , описывающую представление неупорядоченного доступа.

Значение null pDesc используется для инициализации дескриптора по умолчанию, если это возможно. Это поведение идентично поведению дескриптора null D3D11, где заполняются значения по умолчанию. Это поведение наследует формат и измерение ресурса (если не бестипные), а для буферов БПЛА нацелены на полный буфер и являются типизированными, а для текстур БПЛА — первый MIP и все срезы массива. Не все ресурсы поддерживают инициализацию дескриптора NULL.

[in] DestDescriptor

Тип: D3D12_CPU_DESCRIPTOR_HANDLE

Описывает дескриптор ЦП, представляющий начало кучи, содержащей представление неупорядоченного доступа.

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

None

Требования

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

ID3D12Device