Метод IDXCoreAdapter::SetState

Статья
06/13/2023

Задает состояние указанного элемента на адаптере. Перед вызовом SetState для типа свойства вызовите IsSetStateSupported , чтобы убедиться, что настройка типа состояния доступна для этого адаптера и операционной системы (ОС).

Синтаксис

virtual HRESULT STDMETHODCALLTYPE SetState( 
  DXCoreAdapterState state,
  size_t inputStateDetailsSize,
  _In_reads_bytes_opt_(inputStateDetailsSize) const void *inputStateDetails,
  size_t inputDataSize,
  _In_reads_bytes_(inputDataSize) const void *inputData) = 0;

template <class T1, class T2>
HRESULT SetState( 
  DXCoreAdapterState state,
  const T1 *inputStateDetails,
  const T2 *inputData);

Параметры

Состояние

Тип: DXCoreAdapterState

Тип элемента состояния на адаптере, состояние которого требуется задать. Дополнительные сведения о каждом типе состояния адаптера см. в таблице DXCoreAdapterState .

inputStateDetailsSize

Тип: size_t

Размер (в байтах) буфера сведений о входном состоянии, который вы (при необходимости) выделяете и предоставляете в inputStateDetails.

inputStateDetails [in]

Тип: void const*

Необязательный указатель на буфер сведений о константном входном состоянии, который выделяется в приложении, содержащий все сведения о запросе, необходимые для типа состояния, указанного в состоянии. Дополнительные сведения о требованиях к входным буферам для заданного типа состояния см. в таблице DXCoreAdapterState .

inputDataSize

Тип: size_t

Размер (в байтах) входного буфера, который выделяется и предоставляется в inputData.

inputData [in]

Тип: void*

Указатель на входной буфер, выделенный в приложении, содержащий сведения о состоянии, заданные для элемента состояния, тип которого указан в состоянии. Дополнительные сведения о требованиях входного буфера для заданного типа состояния см. в таблице DXCoreAdapterState .

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

Тип: HRESULT

Если функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT.

Возвращаемое значение	Описание
DXGI_ERROR_DEVICE_REMOVED	Адаптер больше не находится в допустимом состоянии.
DXGI_ERROR_INVALID_CALL	Тип состояния, указанный в состоянии , не распознается данной операционной системой (ОС). Вызовите IsSetStateSupported , чтобы убедиться, что для этого адаптера и операционной системы (ОС) доступно задание типа состояния.
DXGI_ERROR_UNSUPPORTED	Тип состояния, указанный в состоянии , не поддерживается адаптером. Вызовите IsSetStateSupported , чтобы убедиться, что для этого адаптера и операционной системы (ОС) доступно задание типа состояния.
E_INVALIDARG	Для inputData (или для inputStateDetails ), где необходим буфер сведений о входном состоянии, предусмотрен недостаточный размер буфера.
E_POINTER	`nullptr` был предоставлен для inputData (или для inputStateDetails, где необходим буфер сведений о входном состоянии).

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

IDXCoreAdapter, DXCore Reference, Using DXCore to enumerate adapters