共用方式為

IDXCoreAdapterList：：GetAdapter 方法

  • 發行項

依索引從 DXCore 配接器清單物件擷取特定配接器。 如需程式設計指引和程式碼範例，請參閱 使用 DXCore 列舉配接器。

語法

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

參數

索引

類型： uint32_t

以零起始的索引，識別 DXCore 配接器清單中的配接器實例。

riid

類型： REFIID

您想要在 ppvAdapter中傳回之介面的全域唯一識別碼 (GUID) 參考。 這必須是 IDXCoreAdapter (IID) 介面識別碼。

ppvAdapter [out]

類型： void**

具有 riid 參數中所指定 IID 之介面的指標位址。 成功傳回時， *ppvAdapter (取值位址) 包含所建立 DXCore 配接器的指標。

傳回

類型： HRESULT

如果函式成功，它會 傳回S_OK。 否則，它會傳回 HRESULT錯誤碼。

傳回值 描述
DXGI_ERROR_DEVICE_REMOVED 索引有效，但配接器不再處於有效狀態。
E_INVALIDARG 提供的 索引 無效。
E_NOINTERFACE 為 riid提供不正確值。
E_POINTER nullptr 已提供給 ppvAdapter。

備註

多個呼叫會傳遞代表相同配接器的索引會傳回相同的介面指標，即使是在不同的配接器清單上也一樣。 因此，您可以放心地比較介面指標，以判斷多個指標是否參考相同的配接器物件。

另請參閱

IDXCoreAdapterList、 DXCore 參考、 使用 DXCore 列舉配接器