Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IDXGIFactory::CreateSoftwareAdapter method

Create an adapter interface that represents a software adapter.

Syntax


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

Parameters

Module [in]

Type: HMODULE

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

ppAdapter [out]

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.

Windows Phone 8: This API is supported.

Requirements

Header

DXGI.h

Library

DXGI.lib

See also

IDXGIFactory

 

 

Community Additions

Show:
© 2014 Microsoft