DXCoreCreateAdapterFactory function (dxcore.h)
Creates a DXCore adapter factory, which you can use to generate further DXCore objects. For programming guidance, and code examples, see Using DXCore to enumerate adapters.
Syntax
HRESULT DXCoreCreateAdapterFactory(
REFIID riid,
[out] void **ppvFactory
);
Parameters
riid
Type: REFIID
A reference to the globally unique identifier (GUID) of the interface that you wish to be returned in ppvFactory. This is expected to be the interface identifier (IID) of IDXCoreAdapterFactory.
[out] ppvFactory
Type: void**
The address of a pointer to an interface with the IID specified in the riid parameter. Upon successful return, *ppvFactory (the dereferenced address) contains a pointer to the DXCore factory created.
Return value
Type: HRESULT
If the function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
| Return value | Description |
|---|---|
| E_NOINTERFACE | An invalid value was provided for riid. |
| E_POINTER | nullptr was provided for ppvFactory. |
Remarks
For the duration of time that a reference exists on an IDXCoreAdapterFactory interface, an IDXCoreAdapterList interface, or an IDXCoreAdapter interface, additional calls to DXCoreCreateAdapterFactory, IDXCoreAdapterList::GetFactory, or IDXCoreAdapter::GetFactory will return pointers to the same object, increasing the reference count of the IDXCoreAdapterFactory interface.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 10 (Build 18936) |
| Target Platform | Windows |
| Header | dxcore.h |
| Library | dxcore.lib |
| DLL | dxcore.dll |