次の方法で共有

DirectDrawCreate 関数 (ddraw.h)

  • [アーティクル]

DirectDraw オブジェクトのインスタンスを作成します。 この関数を使用して作成された DirectDraw オブジェクトは、DirectX 7.0 の Direct3D インターフェイスの完全なセットをサポートしていません。 DirectX 7.0 で Direct3D のすべての機能を公開できる DirectDraw オブジェクトを作成するには、 DirectDrawCreateEx 関数を使用します。

構文

HRESULT DirectDrawCreate(
  [in]  GUID         *lpGUID,
  [out] LPDIRECTDRAW *lplpDD,
  [in]  IUnknown     *pUnkOuter
);

パラメーター

[in] lpGUID

作成するドライバーを表すグローバル一意識別子 (GUID) へのポインター。 アクティブなディスプレイ ドライバーを示すには NULL を指定するか、次のいずれかのフラグを渡して、デバッグ目的でアクティブなディスプレイ ドライバーの動作を制限できます。

DDCREATE_EMULATIONONLY

DirectDraw オブジェクトは、すべての機能にエミュレーションを使用します。ハードウェアでサポートされている機能は利用されません。

DDCREATE_HARDWAREONLY

DirectDraw オブジェクトは、ハードウェアでサポートされていない機能をエミュレートしません。 サポートされていない機能を必要とするメソッドを呼び出そうとすると失敗し、DDERR_UNSUPPORTEDが返されます。

[out] lplpDD

呼び出しが成功した場合に有効な IDirectDraw インターフェイス ポインターに設定される変数へのポインター。

[in] pUnkOuter

COM 集計機能との将来の互換性を確保します。 ただし、現時点では、このパラメーターが NULL 以外の場合、この関数はエラーを返します。

戻り値

関数が成功した場合、戻り値はDD_OK。

失敗した場合、関数は次のいずれかのエラー値を返すことができます。

  • DDERR_DIRECTDRAWALREADYCREATED
  • DDERR_GENERIC
  • DDERR_INVALIDDIRECTDRAWGUID
  • DDERR_INVALIDPARAMS
  • DDERR_NODIRECTDRAWHW
  • DDERR_OUTOFMEMORY

注釈

この関数は DirectDraw オブジェクトの初期化を試み、呼び出しが成功した場合は オブジェクトへのポインターを設定します。

複数のモニターがあるコンピューターで lpGUID に NULL を指定した場合、DirectDraw オブジェクトは通常の協調レベルが設定されている場合にエミュレーション モードで実行されます。 これらのコンピューターでハードウェア アクセラレーションを使用するには、デバイスの GUID を指定します。

LoadLibrary を使用して Ddraw.dll に明示的にリンクしてから、GetProcAddress を使用して DirectDrawCreate 関数にアクセスする必要があります。

要件

要件 値
対象プラットフォーム Windows
ヘッダー ddraw.h
Library Ddraw.lib
[DLL] Ddraw.dll