IDXGIFactoryMedia

DirectComposition サーフェスを使用してビデオをデコードおよび表示するデスクトップメディアアプリ向けに、スワップチェーンを作成します。

Microsoft DirectX Graphics Infrastructure (DXGI) メディアファクトリインターフェイスを作成するには、IDXGIFactoryMedia を CreateDXGIFactory 関数または CreateDXGIFactory1 関数のいずれかに渡すか、CreateDXGIFactory、CreateDXGIFactory1、または CreateDXGIFactory2 によって返されたファクトリオブジェクトから QueryInterface を呼び出します。

スワップチェーンを作成しなくても Direct3D デバイスを作成できるため、スワップチェーンを作成するには、デバイスの作成に使用されたファクトリを取得する必要がある場合があります。 Direct3D デバイスから IDXGIDevice、IDXGIDevice1、IDXGIDevice2、または IDXGIDevice3 インターフェイスを要求し、IDXGIObject::GetParent メソッドを使用してファクトリを見つけることができます。次のコードにその方法を示します。

IDXGIDevice2 * pDXGIDevice;
hr = g_pd3dDevice->QueryInterface(__uuidof(IDXGIDevice2), (void **)&pDXGIDevice);
      
IDXGIAdapter * pDXGIAdapter;
hr = pDXGIDevice->GetParent(__uuidof(IDXGIAdapter), (void **)&pDXGIAdapter);

IDXGIFactoryMedia * pIDXGIFactory;
pDXGIAdapter->GetParent(__uuidof(IDXGIFactoryMedia), (void **)&pIDXGIFactory);

既存の DirectComposition サーフェスハンドルに対して、YUV スワップチェーンを作成します。(IDXGIFactoryMedia.CreateSwapChainForCompositionSurfaceHandle)

CreateSwapChainForCompositionSurfaceHandle は次の値を返します。

• スワップチェーンの作成に成功した場合は S_OK。
• 操作を完了するためのメモリが不足している場合は E_OUTOFMEMORY。
• 呼び出し元のアプリケーションが無効なデータを指定した場合(たとえば pDesc、pYuvDecodeBuffers、または ppSwapChain が NULL の場合)は DXGI_ERROR_INVALID_CALL。
• pDevice に渡すデバイスの種類によって定義される、DXGI_ERROR トピックに記載されているその他のエラーコードが返される場合があります。

既存の DirectComposition サーフェスハンドルに対して、YUV スワップチェーンを作成します。(IDXGIFactoryMedia.CreateDecodeSwapChainForCompositionSurfaceHandle)

CreateDecodeSwapChainForCompositionSurfaceHandle は次の値を返します。

• スワップチェーンの作成に成功した場合は S_OK。
• 操作を完了するためのメモリが不足している場合は E_OUTOFMEMORY。
• 呼び出し元のアプリケーションが無効なデータを指定した場合(たとえば pDesc、pYuvDecodeBuffers、または ppSwapChain が NULL の場合)は DXGI_ERROR_INVALID_CALL。
• pDevice に渡すデバイスの種類によって定義される、DXGI_ERROR トピックに記載されているその他のエラーコードが返される場合があります。

pYuvDecodeBuffers パラメーターを介して指定される IDXGIResource は、少なくとも 1 つのサブリソースを指している必要があり、すべてのサブリソースは D3D11_BIND_DECODER フラグを使用して作成されている必要があります。