IDXGIFactory::CreateSoftwareAdapter メソッド (dxgi.h)

  • [アーティクル]

ソフトウェア アダプターを表すアダプター インターフェイスを作成します。

構文

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

パラメーター

Module

種類: HMODULE

ソフトウェア アダプターの dll を処理します。 HMODULE は、 GetModuleHandle または LoadLibrary を使用して取得できます。

[out] ppAdapter

種類: IDXGIAdapter**

アダプターへのポインターのアドレス ( 「IDXGIAdapter」を参照)。

戻り値

型: HRESULT

成功または失敗を示す リターン コード 。

解説

ソフトウェア アダプターは、デバイス ドライバー インターフェイス全体に加え、必要に応じて Windows 用のカーネル モード グラフィックス コンポーネントのエミュレーションを実装する DLL です。 ソフトウェア アダプターの実装の詳細については、Windows Vista ドライバー開発キットを参照してください。 これは非常に複雑な開発タスクであり、一般的な読者にはお勧めしません。

このメソッドを呼び出すと、モジュールの参照カウントが 1 ずつインクリメントされます。 参照カウントは、 FreeLibrary を呼び出すことによってデクリメントできます。

一般的な呼び出しシナリオは、 LoadLibrary を呼び出し、ハンドルを CreateSoftwareAdapter に渡してから、DLL で FreeLibrary をすぐに呼び出し、DLL の HMODULE を忘れるというシナリオです。 ソフトウェア アダプターは破棄されると FreeLibrary を呼び出すので、DLL の有効期間はアダプターによって所有され、アプリケーションはその有効期間をさらに考慮する必要はありません。

要件

   
対象プラットフォーム Windows
ヘッダー dxgi.h
Library DXGI.lib

関連項目

IDXGIFactory