IDXGIFactory::CreateSoftwareAdapter method (dxgi.h)

Create an adapter interface that represents a software adapter.

Syntax

HRESULT CreateSoftwareAdapter(
        HMODULE      Module,
  [out] IDXGIAdapter **ppAdapter
);

Parameters

Module

Type: HMODULE

Handle to the software adapter's dll. HMODULE can be obtained with GetModuleHandle or LoadLibrary.

[out] ppAdapter

Type: IDXGIAdapter**

Address of a pointer to an adapter (see IDXGIAdapter).

Return value

Type: HRESULT

A return code indicating success or failure.

Remarks

A software adapter is a DLL that implements the entirety of a device driver interface, plus emulation, if necessary, of kernel-mode graphics components for Windows. Details on implementing a software adapter can be found in the Windows Vista Driver Development Kit. This is a very complex development task, and is not recommended for general readers.

Calling this method will increment the module's reference count by one. The reference count can be decremented by calling FreeLibrary.

The typical calling scenario is to call LoadLibrary, pass the handle to CreateSoftwareAdapter, then immediately call FreeLibrary on the DLL and forget the DLL's HMODULE. Since the software adapter calls FreeLibrary when it is destroyed, the lifetime of the DLL will now be owned by the adapter, and the application is free of any further consideration of its lifetime.

Requirements

See also

IDXGIFactory