IDXGIResource1

IDXGIResource1 インターフェイスは、サブリソースサーフェスオブジェクトの作成と、共有リソースへのハンドルの作成のサポートを追加することで、IDXGIResource インターフェイスを拡張します。

リソースが現在配置されているメモリの種類を判別するには、IDXGIDevice::QueryResourceResidency を使用します。 プロセス間でリソースを共有するには、ID3D11Device1::OpenSharedResource1 を使用します。 Direct3D 11、Direct2D、Direct3D 10、Direct3D 9Ex などの複数の Windows グラフィックス API 間でリソースを共有する方法については、Surface Sharing Between Windows Graphics APIs を参照してください。

IDXGIResource1 インターフェイスは、Direct3D 10 以降の関数から作成した任意のビデオメモリリソースから取得できます。ID3D10Resource または ID3D11Resource をサポートする Direct3D オブジェクトはすべて IDXGIResource1 もサポートします。たとえば、ID3D11Device::CreateTexture2D から作成する Direct3D 2D テクスチャオブジェクトは IDXGIResource1 をサポートします。2D テクスチャオブジェクト(ID3D11Texture2D)に対して QueryInterface を呼び出すことで IDXGIResource1 インターフェイスを取得できます。たとえば、2D テクスチャオブジェクトから IDXGIResource1 インターフェイスを取得するには、次のコードを使用します。

IDXGIResource1 * pDXGIResource;
hr = g_pd3dTexture2D->QueryInterface(__uuidof(IDXGIResource1), (void **)&pDXGIResource);

Windows Phone 8: この API はサポートされています。

サブリソースサーフェスオブジェクトを作成します。

成功した場合は S_OK を返します。それ以外の場合は、次のいずれかの値を返します。

• インデックスが範囲外の場合、またはサブリソースが有効なサーフェスでない場合は DXGI_ERROR_INVALID_CALL。
• サブリソースサーフェスオブジェクトを作成するのに十分なメモリがない場合は E_OUTOFMEMORY。

サブリソースサーフェスオブジェクトは IDXGISurface2 インターフェイスを実装します。これは IDXGISurface1 を継承し、間接的に IDXGISurface を継承します。 したがって、元のリソースインターフェイスオブジェクトが GDI 相互運用フラグ(D3D11_RESOURCE_MISC_GDI_COMPATIBLE)を指定して作成されていれば、IDXGISurface1 の GDI 相互運用メソッドが機能します。

CreateSubresourceSurface は、CreateSubresourceSurface を呼び出したリソースインターフェイスに基づくサブリソースサーフェスを作成します。たとえば、元のリソースインターフェイスオブジェクトが 2D テクスチャの場合、作成されるサブリソースサーフェスも 2D テクスチャになります。

CreateSubresourceSurface を使用してステレオリソースの一部を作成すると、ステレオリソースの左側または右側の部分に対して Direct2D を使用できます。

共有リソースへのハンドルを作成します。返されたハンドルは複数の Direct3D デバイスで使用できます。

成功した場合は S_OK を返します。それ以外の場合は、次のいずれかの値を返します。

• パラメーターのいずれかが無効な場合は DXGI_ERROR_INVALID_CALL。
• 指定された共有リソースの名前が既に別のリソースに関連付けられている場合は DXGI_ERROR_NAME_ALREADY_EXISTS。
• 保護された名前空間にオブジェクトが作成されている場合は E_ACCESSDENIED。
• ハンドルを作成するのに十分なメモリがない場合は E_OUTOFMEMORY。
• その他、DXGI_ERROR トピックで説明されているエラーコードが返される可能性があります。

CreateSharedHandle が NT ハンドルを返すのは、リソースを共有として作成し、NT ハンドルを使用することを指定した場合(つまり D3D11_RESOURCE_MISC_SHARED_NTHANDLE フラグと D3D11_RESOURCE_MISC_SHARED_KEYEDMUTEX フラグを設定した場合)のみです。リソースを共有として作成し、NT ハンドルを使用することを指定した場合は、共有用のハンドルを取得するために CreateSharedHandle を使用する必要があります。 この状況では、IDXGIResource::GetSharedHandle メソッドは失敗するため使用できません。

CreateSharedHandle が返すハンドルを ID3D11Device1::OpenSharedResource1 メソッドの呼び出しに渡すことで、別のデバイスで作成した共有リソースへのアクセス権をデバイスに与えることができます。

CreateSharedHandle が返すハンドルは NT ハンドルであるため、CloseHandle、DuplicateHandle などでハンドルを使用できます。CreateSharedHandle は共有リソースに対して 1 回だけ呼び出すことができ、以降の呼び出しは失敗します。 同じ共有リソースへのハンドルがさらに必要な場合は、DuplicateHandle を呼び出します。共有リソースハンドルが不要になったら、メモリリークを避けるために CloseHandle を呼び出してハンドルを閉じます。

リソースを共有するために CreateSharedHandle を呼び出すときに lpName にリソースの名前を渡した場合、後でこの名前を ID3D11Device1::OpenSharedResourceByName メソッドの呼び出しに渡すことで、別のデバイスに共有リソースへのアクセス権を与えることができます。名前付きリソースを使用すると、悪意のあるユーザーがこの名前付きリソースを先に使用し、アプリの起動を妨げる可能性があります。この状況を防ぐには、ランダムな名前のリソースを作成し、その名前を認可されたユーザーだけが取得できるように保存します。あるいは、この目的でファイルを使用することもできます。アプリをユーザーごとに 1 つのインスタンスに制限するには、ユーザーのプロファイルディレクトリにロックされたファイルを作成します。

リソースを共有として作成し、NT ハンドルを使用することを指定しなかった場合、CreateSharedHandle は失敗するため、共有用のハンドルを取得するために CreateSharedHandle を使用することはできません。

Examples

ID3D11Texture2D* pTexture2D;
ID3D11Device* pDevice;

pDevice->CreateTexture2D(…, &pTexture2D); // Create the texture as shared with NT HANDLEs.

HANDLE handle;
IDXGIResource1* pResource;
pTexture2D->QueryInterface(__uuidof(IDXGIResource1), (void**) &pResource);
pResource->CreateSharedHandle(NULL, 
         DXGI_SHARED_RESOURCE_READ | DXGI_SHARED_RESOURCE_WRITE, 
         NULL,
         &handle);

// Pass the handle to another process to share the resource.