Метод IDXCoreAdapter::GetProperty

  • Статья

Извлекает значение указанного свойства адаптера. Перед вызовом GetProperty для типа свойства вызовите IsPropertySupported , чтобы убедиться, что тип свойства доступен для этого адаптера и операционной системы (ОС). Кроме того, перед вызовом GetProperty вызовите Метод GetPropertySize , чтобы определить необходимый размер буфера, в котором будет получено значение свойства.

Синтаксис

virtual HRESULT STDMETHODCALLTYPE GetProperty(
  DXCoreAdapterProperty property,
  size_t bufferSize,
  _Out_writes_bytes_(bufferSize) void *propertyData) = 0;

template <class T>
HRESULT GetProperty( 
  DXCoreAdapterProperty property,
  _Out_writes_bytes_(sizeof(T)) T *propertyData);

Параметры

свойство;

Тип: DXCoreAdapterProperty

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

bufferSize

Тип: size_t

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

propertyData [out]

Тип: void*

Указатель на выходной буфер, который выделяется в приложении и заполняется функцией. Вызовите Метод GetPropertySize , чтобы определить размер буфера propertyData для данного свойства адаптера.

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

Тип: HRESULT

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

Возвращаемое значение Описание
DXGI_ERROR_INVALID_CALL Тип свойства, указанный в свойстве , не распознается данной операционной системой (ОС). Вызовите IsPropertySupported , чтобы убедиться, что тип свойства доступен для этого адаптера и операционной системы (ОС).
DXGI_ERROR_UNSUPPORTED Тип свойства, указанный в свойстве , не поддерживается адаптером. Вызовите IsPropertySupported , чтобы убедиться, что тип свойства доступен для этого адаптера и операционной системы (ОС).
E_INVALIDARG В propertyData указан недостаточный размер буфера. Вызовите Метод GetPropertySize , чтобы определить размер буфера propertyData для данного свойства адаптера.
E_POINTER nullptr был предоставлен для propertyData.

Комментарии

Вы можете вызвать GetProperty на адаптере, который больше не является допустимым. В результате функция не завершится сбоем. Эта функция обнуляет буфер propertyData перед его заполнением.

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

IDXCoreAdapter, DXCore Reference, Using DXCore to enumerate adapters