Método IDXCoreAdapterList::GetAdapter

Recupera un adaptador específico por índice de un objeto de lista de adaptadores DXCore. Para obtener instrucciones de programación y ejemplos de código, consulte Uso de DXCore para enumerar adaptadores.

Sintaxis

virtual HRESULT STDMETHODCALLTYPE GetAdapter(
  uint32_t index,
  REFIID riid,
  _COM_Outptr_ void **ppvAdapter) = 0;

template<class T>
HRESULT STDMETHODCALLTYPE GetAdapter( 
  uint32_t index,
  _COM_Outptr_ T **ppvAdapter);

Parámetros

índice

Tipo: uint32_t

Índice de base cero, que identifica una instancia de adaptador dentro de la lista de adaptadores DXCore.

riid

Tipo: REFIID

Referencia al identificador único global (GUID) de la interfaz que desea devolver en ppvAdapter. Se espera que sea el identificador de interfaz (IID) de IDXCoreAdapter.

ppvAdapter [out]

Tipo: void**

Dirección de un puntero a una interfaz con el IID especificado en el parámetro riid . Tras la devolución correcta, *ppvAdapter (la dirección desreferenciada) contiene un puntero al adaptador DXCore creado.

Devoluciones

Tipo: HRESULT

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

Valor devuelto	Descripción
DXGI_ERROR_DEVICE_REMOVED	El índice es válido, pero el adaptador ya no está en un estado válido.
E_INVALIDARG	El índice proporcionado no es válido.
E_NOINTERFACE	Se proporcionó un valor no válido para riid.
E_POINTER	nullptr se proporcionó para ppvAdapter.

Comentarios

Varias llamadas que pasan un índice que representa el mismo adaptador devuelven punteros de interfaz idénticos, incluso en distintas listas de adaptadores. Como resultado, es seguro comparar punteros de interfaz para determinar si varios punteros hacen referencia al mismo objeto de adaptador.

Consulte también

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