DCompositionCreateDevice2 関数 (dcomp.h)

[アーティクル]
08/23/2023

他の Microsoft DirectComposition オブジェクトを作成するために使用できる新しいデバイスオブジェクトを作成します。

構文

HRESULT DCompositionCreateDevice2(
  [in, optional] IUnknown *renderingDevice,
  [in]           REFIID   iid,
  [out]          void     **dcompositionDevice
);

パラメーター

[in, optional] renderingDevice

DirectComposition サーフェスオブジェクトの作成に使用する DirectX デバイスへのオプションのポインター。 IDXGIDevice または ID2D1Device インターフェイスを実装するオブジェクトへのポインターである必要があります。

[in] iid

取得するインターフェイスの識別子。これは、__uuidof(IDCompositionDevice) または __uuidof(IDCompositionDesktopDevice) のいずれかである必要があります。

[out] dcompositionDevice

新しく作成されたデバイスオブジェクトへのインターフェイスポインターを受け取ります。ポインターは、 iid パラメーターで指定された型です。このパラメーターを NULL にすることはできません。

戻り値

関数が成功した場合は、S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。エラーコードの一覧については、「 DirectComposition エラーコード」を参照してください。

注釈

デバイスオブジェクトは、他のすべての DirectComposition オブジェクトのファクトリとして機能します。また、IDCompositionDevice2::Commit メソッドを使用してトランザクションコンポジションを制御します。

renderingDevice パラメーターは、DXGI、Direct3D、Direct2D デバイスオブジェクトを指しているか、NULL である可能性があります。このパラメーターは、IDCompositionDevice2::CreateSurface、IDCompositionDevice2::CreateVirtualSurface メソッド、および IDCompositionSurface::BeginDraw メソッドの動作に影響します。

renderingDevice パラメーターが NULL の場合、返される DirectComposition デバイスは DirectComposition サーフェスオブジェクトを直接作成できません。特に、IDCompositionDevice2::CreateSurface メソッドと IDCompositionDevice2::CreateVirtualSurface メソッドは、指定されたパラメーターに関係なく、E_INVALIDARGを返します。ただし、アプリケーションが IDCompositionDevice2::CreateSurfaceFactory メソッドを使用してサーフェスファクトリオブジェクトを作成する場合は、このような DirectComposition デバイスオブジェクトを使用してサーフェスを間接的に作成できます。

renderingDevice パラメーターが DXGI デバイスを指している場合、そのデバイスを使用して、IDCompositionDevice2::CreateSurface メソッドと IDCompositionDevice2::CreateVirtualSurface メソッドで必要なすべてのビデオメモリが割り当てられます。さらに、IDCompositionSurface::BeginDraw メソッドは、同じ DXGI デバイスに属する DXGI サーフェスへのインターフェイスポインターを返します。

renderingDevice パラメーターが Direct2D デバイスオブジェクトを指している場合、DirectComposition はそのオブジェクトから基になる DXGI デバイスオブジェクトを抽出し、その DXGI デバイスオブジェクトが renderingDevice パラメーターとして渡されたかのように使用します。ただし、Direct2D オブジェクトをさらに渡すと、IDCompositionSurface::BeginDraw は、IDCompositionDevice2::CreateSurface メソッドまたは IDCompositionDevice2::CreateVirtualSurface メソッドで作成されたオブジェクトの iid パラメーターに対して、__uuidof(ID2D1DeviceContext) を受け入れます。その場合、IDCompositionSurface::BeginDraw によって返される Direct2D デバイスコンテキストオブジェクトは、 renderingDevice パラメーターとして渡されたのと同じ Direct2D デバイスに属します。

iid パラメーターが __uuidof(IDCompositionDevice) の場合、dcompositionDevice パラメーターはバージョン 1 の IDCompositionDevice インターフェイスへのポインターを受け取りますが、基になるオブジェクトはバージョン 2 のデスクトップデバイスオブジェクトです。アプリケーションは後で、そのデバイスで QueryInterface メソッドを呼び出すことによって、IDCompositionDevice2 インターフェイスまたは IDCompositionDesktopDevice インターフェイスへのポインターを取得できます。同様に、このようなデバイスから作成されたすべての DirectComposition オブジェクトは、内部のバージョン 2 オブジェクトです。たとえば、IDCompositionDevice::CreateVisual メソッドは、作成されたビジュアルに IDCompositionVisual インターフェイスを返しますが、アプリケーションは QueryInterface メソッドを使用して IDCompositionVisual2 インターフェイスへのポインターを取得できます。この動作により、DirectComposition V1 API に書き込まれたアプリケーションは、IDCompositionDevice2 インターフェイスを要求しながら、デバイスの作成方法を DCompositionCreateDevice から DCompositionCreateDevice2 に変更することで、DirectComposition V2 機能を段階的に採用できます。これにより、残りのコードは変更されず、アプリケーションは新しい機能が必要な場所でのみ QueryInterface を使用できます。

要件

要件	値
サポートされている最小のクライアント	Windows 8.1 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2012 R2 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	dcomp.h
Library	Dcomp.lib
[DLL]	Dcomp.dll

こちらもご覧ください

IDCompositionDesktopDevice

IDCompositionDevice2

IDCompositionDevice2::CreateSurface

IDCompositionDevice2::CreateSurfaceFactory

IDCompositionDevice2::CreateVirtualSurface

IDCompositionSurface::BeginDraw

次の方法で共有

DCompositionCreateDevice2 関数 (dcomp.h)

構文

パラメーター

戻り値

注釈

要件

こちらもご覧ください

フィードバック

その他のリソース