Método IDXCoreAdapter::GetProperty

Artículo
08/18/2023

Recupera el valor de la propiedad de adaptador especificada. Antes de llamar a GetProperty para un tipo de propiedad, llame a IsPropertySupported para confirmar que el tipo de propiedad está disponible para este adaptador y sistema operativo (SO). Además, antes de llamar a GetProperty, llame a GetPropertySize para determinar el tamaño necesario del búfer en el que se va a recibir el valor de propiedad.

Sintaxis

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);

Parámetros

propiedad

Tipo: DXCoreAdapterProperty

Tipo de la propiedad cuyo valor desea recuperar. Consulta la tabla en DXCoreAdapterProperty para obtener más información sobre cada propiedad del adaptador.

bufferSize

Tipo: size_t

Tamaño, en bytes, del búfer de salida que asigne y proporcione en propertyData.

propertyData [out]

Tipo: void*

Puntero a un búfer de salida que se asigna en la aplicación y que la función rellena. Llame a GetPropertySize para determinar el tamaño que debe tener el búfer propertyData para una propiedad de adaptador determinada.

Devoluciones

Tipo: HRESULT

Si la función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT.

Valor devuelto	Descripción
DXGI_ERROR_INVALID_CALL	Este sistema operativo (SO) no reconoce el tipo de propiedad especificado en la propiedad . Llame a IsPropertySupported para confirmar que el tipo de propiedad está disponible para este adaptador y sistema operativo (SO).
DXGI_ERROR_UNSUPPORTED	El adaptador no admite el tipo de propiedad especificado en la propiedad . Llame a IsPropertySupported para confirmar que el tipo de propiedad está disponible para este adaptador y sistema operativo (SO).
E_INVALIDARG	Se proporciona un tamaño de búfer insuficiente en propertyData. Llame a GetPropertySize para determinar el tamaño que debe tener el búfer propertyData para una propiedad de adaptador determinada.
E_POINTER	`nullptr` se proporcionó para propertyData.

Observaciones

Puede llamar a GetProperty en un adaptador que ya no sea válido; la función no producirá un error como resultado de eso. Esta función se agota el búfer propertyData antes de rellenarlo.

Consulte también

IDXCoreAdapter, Referencia de DXCore, Uso de DXCore para enumerar adaptadores