Метод ID3D11DeviceContext1::VSSetConstantBuffers1 (d3d11_1.h)

Статья
08/22/2023

Задает буферы констант, которые использует этап конвейера вершинного шейдера.

Синтаксис

void VSSetConstantBuffers1(
  [in]           UINT         StartSlot,
  [in]           UINT         NumBuffers,
  [in, optional] ID3D11Buffer * const *ppConstantBuffers,
  [in, optional] const UINT   *pFirstConstant,
  [in, optional] const UINT   *pNumConstants
);

Параметры

[in] StartSlot

Тип: UINT

Выполните индекс в отсчитываемом от нуля массиве устройства, чтобы задать буферам констант значение (в диапазоне от 0 до D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT – 1).

[in] NumBuffers

Тип: UINT

Число заданных буферов (в диапазоне от 0 до D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT — StartSlot).

[in, optional] ppConstantBuffers

Тип: ID3D11Buffer*

Массив буферов констант, передаваемых устройству.

[in, optional] pFirstConstant

Тип: const UINT*

Массив, содержащий смещения в буферах, которые указывает ppConstantBuffers . Каждое смещение указывает, где, с точки зрения шейдера, начинается каждый буфер констант. Каждое смещение измеряется в константах шейдера, которые имеют размер 16 байт (4*32-разрядные компоненты). Таким образом, смещение 16 указывает, что начало связанного буфера констант составляет 256 байт в буфер констант. Каждое смещение должно быть кратно 16 констант.

[in, optional] pNumConstants

Тип: const UINT*

Массив, содержащий количество констант в буферах, которые указывает ppConstantBuffers . Каждое число определяет количество констант, содержащихся в буфере констант, используемом шейдером. Каждое число констант начинается с соответствующего смещения, указанного в массиве pFirstConstant . Каждое число констант должно быть кратно 16 констант в диапазоне [0..4096].

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

None

Remarks

Среда выполнения удаляет вызов VSSetConstantBuffers1, если количество констант, на которые указывают точки pNumConstants , превышает максимальный размер буфера констант, поддерживаемый шейдерами (4096 констант). Значения в элементах массивов pFirstConstant и pFirstAntpNumConstant + могут превышать длину каждого буфера. С точки зрения шейдера буфер констант — это пересечение фактического выделения памяти для буфера и окна [значение в элементе pFirstConstant, значение в элементе pFirstConstant + value в элементе pNumConstants]. Среда выполнения также удаляет вызов VSSetConstantBuffers1 в существующих драйверах, которые не поддерживают это смещение.

Среда выполнения эмулирует эту функцию для уровней компонентов 9.1, 9.2 и 9.3; Поэтому эта функция поддерживается для уровней компонентов 9.1, 9.2 и 9.3. Эта функция всегда доступна в новых драйверах для уровня компонентов 10 и выше.

С точки зрения шейдера элемент [0] в массиве буферов констант является константой pFirstConstant.

Вне границ доступа к буферам констант из шейдера в диапазон, определенный pFirstConstant и pNumConstants , возвращает 0.

Если массивы pFirstConstant и pNumConstants имеют значение NULL, вы получите тот же результат, что и при привязке всего буфера к представлению. Этот же результат можно получить при вызове метода VSSetConstantBuffers . Если буфер больше максимального размера буфера констант, поддерживаемого шейдерами (4096 элементов), шейдер может получить доступ только к первым константам 4096.

Если pFirstConstant или pNumConstants имеет значение NULL, другой параметр также должен иметь значение NULL.

Вызов VSSetConstantBuffers1 с эмуляцией списка команд

Эмуляция списка командсреды выполнения VSSetConstantBuffers1 иногда фактически не изменяет смещения или размеры массивов буферов констант. Такое поведение возникает, когда

VSSetConstantBuffers1 не изменяет буферы констант в начале и конце диапазона слотов, которые вы настроили для обновления. В этом разделе показано, как обойти эту проблему

Поведение.

Ниже приведен код для проверка, эмулирует ли среда выполнения списки команд или драйвер поддерживает списки команд:


     HRESULT hr = S_OK;
     bool needWorkaround = false;
     D3D11_DEVICE_CONTEXT_TYPE contextType = pDeviceContext->GetType();

     if( D3D11_DEVICE_CONTEXT_DEFERRED == contextType)
     {
          D3D11_FEATURE_DATA_THREADING threadingCaps = { FALSE, FALSE };

          hr = pDevice->CheckFeatureSupport( D3D11_FEATURE_THREADING, &threadingCaps, sizeof(threadingCaps) );
          if( SUCCEEDED(hr) && !threadingCaps.DriverCommandLists )
          {
               needWorkaround = true; // the runtime emulates command lists.
          }
     }

Если среда выполнения эмулирует списки команд, необходимо использовать один из следующих фрагментов кода:

Если изменить смещение и размер только для одного буфера констант, сначала задайте для буфера констант значение NULL :


     pDeviceContext->VSSetConstantBuffers1(0, 1, &CBuf, &Offset, &Count);
     if( needWorkaround )
     {
          // Workaround for command list emulation
          pDeviceContext->VSSetConstantBuffers(0, 1, &NullCBuf);
     }
     pDeviceContext->VSSetConstantBuffers1(0, 1, &CBuf, &Offset, &Count);

Если изменить несколько буферов констант, сначала задайте для первого и последнего буферов констант диапазона значение NULL :


     pDeviceContext->VSSetConstantBuffers1(0, 4, &CBufs, &Offsets, &Counts);
     if( needWorkaround )
     {
          // Workaround for command list emulation
          pDeviceContext->VSSetConstantBuffers(0, 1, &NullCBuf);
          pDeviceContext->VSSetConstantBuffers(3, 1, &NullCBuf);
     }
     pDeviceContext->VSSetConstantBuffers1(0, 4, &CBufs, &Offsets, &Counts);

Требования


Минимальная версия клиента	Windows 8 и Обновление платформы для Windows 7 [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2012 и обновление платформы для Windows Server 2008 R2 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	d3d11_1.h
Библиотека	D3D11.lib

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

ID3D11DeviceContext1

Поделиться через