Método IDXCoreAdapter::SetState

Artículo
08/18/2023

Establece el estado del elemento especificado en el adaptador. Antes de llamar a SetState para un tipo de propiedad, llame a IsSetStateSupported para confirmar que la configuración del tipo de estado está disponible para este adaptador y sistema operativo (SO).

Sintaxis

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

Parámetros

state

Tipo: DXCoreAdapterState

Tipo de elemento de estado en el adaptador cuyo estado desea establecer. Consulta la tabla en DXCoreAdapterState para obtener más información sobre cada tipo de estado de adaptador.

inputStateDetailsSize

Tipo: size_t

El tamaño, en bytes, del búfer de detalles de estado de entrada que asigna y proporciona en inputStateDetails.

inputStateDetails [in]

Tipo: void const*

Puntero opcional a un búfer de detalles de estado de entrada constante que se asigna en la aplicación, que contiene cualquier información sobre la solicitud necesaria para el tipo de estado que especifique en estado. Consulta la tabla en DXCoreAdapterState para obtener más información sobre cualquier requisito de búfer de entrada para un tipo de estado determinado.

inputDataSize

Tipo: size_t

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

inputData [in]

Tipo: void*

Puntero a un búfer de entrada que se asigna en la aplicación, que contiene la información de estado que se va a establecer para el elemento de estado cuyo tipo se especifica en estado. Consulta la tabla en DXCoreAdapterState para obtener más información sobre el requisito del búfer de entrada para un tipo de estado determinado.

Devoluciones

Tipo: HRESULT

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

Valor devuelto	Descripción
DXGI_ERROR_DEVICE_REMOVED	El adaptador ya no está en un estado válido.
DXGI_ERROR_INVALID_CALL	Este sistema operativo (SO) no reconoce el tipo de estado especificado en estado . Llame a IsSetStateSupported para confirmar que la configuración del tipo de estado está disponible para este adaptador y sistema operativo (SO).
DXGI_ERROR_UNSUPPORTED	El adaptador no admite el tipo de estado especificado en estado . Llame a IsSetStateSupported para confirmar que la configuración del tipo de estado está disponible para este adaptador y sistema operativo (SO).
E_INVALIDARG	Se proporciona un tamaño de búfer insuficiente para inputData (o para inputStateDetails donde es necesario un búfer de detalles de estado de entrada).
E_POINTER	`nullptr` se proporcionó para inputData (o para inputStateDetails donde es necesario un búfer de detalles de estado de entrada).

Consulte también

IDXCoreAdapter, referencia de DXCore, uso de DXCore para enumerar adaptadores