IDirect3DDeviceManager9

2 つのスレッドが同じ Direct3D 9 デバイスを共有できるようにし、デバイスの DirectX Video Acceleration (DXVA) 機能へのアクセスを提供します。

このインターフェイスは Direct3D Device Manager によって公開されます。Direct3D デバイスマネージャーを作成するには、DXVA2CreateDirect3DDeviceManager9 を呼び出します。

Enhanced Video Renderer (EVR) からこのインターフェイスを取得するには、IMFGetService::GetService を呼び出します。サービス GUID は MR_VIDEO_ACCELERATION_SERVICE です。DirectShow EVR フィルターの場合は、フィルターのピンに対して GetService を呼び出します。

Direct3D Device Manager は Direct3D 9 デバイスのみをサポートします。DXGI デバイスはサポートしません。

Windows ストアアプリは IMFDXGIDeviceManager と Direct3D 11 Video API を使用する必要があります。

Direct3D デバイスを設定するか、Direct3D デバイスがリセットされたことをデバイスマネージャーに通知します。

このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。

Direct3D デバイスマネージャーを最初に作成したときは、Direct3D デバイスへのポインターを指定してこのメソッドを呼び出します。デバイスマネージャーはデバイスを作成しません。呼び出し側が最初にデバイスポインターを提供する必要があります。

Direct3D デバイスが失われ、デバイスをリセットまたは新しいデバイスを作成する必要がある場合にも、このメソッドを呼び出します。これは IDirect3DDevice9::TestCooperativeLevel が D3DERR_DEVICELOST または D3DERR_DEVICENOTRESET を返した場合に発生します。失われたデバイスの詳細については、Direct3D のドキュメントを参照してください。

resetToken パラメーターにより、デバイスマネージャーを最初に作成したコンポーネントのみが現在のデバイスを無効化できることが保証されます。

このメソッドが成功すると、開いているすべてのデバイスハンドルは無効になります。

Direct3D デバイスへのハンドルを取得します。

このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。

Direct3D デバイスの IDirect3DDevice9 ポインターを取得するには、phDevice で返されたハンドルを指定して IDirect3DDeviceManager9::LockDevice を呼び出します。デバイスハンドルの使用が終わったら、IDirect3DDeviceManager9::CloseDeviceHandle を呼び出してハンドルを閉じます。

デバイスハンドルがまだ有効かどうかをテストするには、IDirect3DDeviceManager9::TestDevice を呼び出します。

Direct3D デバイスハンドルを閉じます。

このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。

Direct3D デバイスハンドルが有効かどうかをテストします。

このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。

このメソッドが DXVA2_E_NEW_VIDEO_DEVICE を返した場合は、IDirect3DDeviceManager9::CloseDeviceHandle を呼び出してハンドルを閉じ、その後 OpenDeviceHandle を再度呼び出して新しいハンドルを取得します。IDirect3DDeviceManager9::ResetDevice メソッドは、開いているすべてのデバイスハンドルを無効化します。

呼び出し側に Direct3D デバイスへの排他的アクセスを与えます。

このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。

Direct3D デバイスの使用が終わったら、IDirect3DDeviceManager9::UnlockDevice を呼び出してデバイスのロックを解除します。

このメソッドが DXVA2_E_NEW_VIDEO_DEVICE を返した場合は、IDirect3DDeviceManager9::CloseDeviceHandle を呼び出してハンドルを閉じ、その後 OpenDeviceHandle を再度呼び出して新しいハンドルを取得します。IDirect3DDeviceManager9::ResetDevice メソッドは、開いているすべてのデバイスハンドルを無効化します。

fBlock が TRUE の場合、このメソッドはデッドロックする可能性があります。たとえば、あるスレッドが LockDevice を呼び出し、その後 LockDevice を呼び出す別のスレッドを待機する場合にデッドロックします。また、あるスレッドが間に UnlockDevice を呼び出さずに LockDevice を 2 回呼び出す場合にもデッドロックします。

例

HRESULT LockDevice(
    IDirect3DDeviceManager9 *pDeviceManager,
    BOOL fBlock,
    IDirect3DDevice9 **ppDevice, // Receives a pointer to the device.
    HANDLE *pHandle              // Receives a device handle.   
    )
{
    *pHandle = NULL;
    *ppDevice = NULL;

    HANDLE hDevice = 0;

    HRESULT hr = pDeviceManager->OpenDeviceHandle(&hDevice);

    if (SUCCEEDED(hr))
    {
        hr = pDeviceManager->LockDevice(hDevice, ppDevice, fBlock);
    }

    if (hr == DXVA2_E_NEW_VIDEO_DEVICE)
    {
        // Invalid device handle. Try to open a new device handle.
        hr = pDeviceManager->CloseDeviceHandle(hDevice);

        if (SUCCEEDED(hr))
        {
            hr = pDeviceManager->OpenDeviceHandle(&hDevice);
        }

        // Try to lock the device again.
        if (SUCCEEDED(hr))
        {
            hr = pDeviceManager->LockDevice(hDevice, ppDevice, TRUE); 
        }
    }

    if (SUCCEEDED(hr))
    {
        *pHandle = hDevice;
    }
    return hr;
}

Direct3D デバイスのロックを解除します。

このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。

DirectX Video Acceleration (DXVA) サービスインターフェイスを取得します。

このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。

このメソッドが DXVA2_E_NEW_VIDEO_DEVICE を返した場合は、IDirect3DDeviceManager9::CloseDeviceHandle を呼び出してハンドルを閉じ、その後 OpenDeviceHandle を再度呼び出して新しいハンドルを取得します。IDirect3DDeviceManager9::ResetDevice メソッドは、開いているすべてのデバイスハンドルを無効化します。

例

HRESULT GetVideoProcessorService(
    IDirect3DDeviceManager9 *pDeviceManager,
    IDirectXVideoProcessorService **ppVPService
    )
{
    *ppVPService = NULL;

    HANDLE hDevice;

    HRESULT hr = pDeviceManager->OpenDeviceHandle(&hDevice);
    if (SUCCEEDED(hr))
    {
        // Get the video processor service 
        HRESULT hr2 = pDeviceManager->GetVideoService(
            hDevice, 
            IID_PPV_ARGS(ppVPService)
            );

        // Close the device handle.
        hr = pDeviceManager->CloseDeviceHandle(hDevice);

        if (FAILED(hr2))
        {
            hr = hr2;
        }
    }

    if (FAILED(hr))
    {
        SafeRelease(ppVPService);
    }

    return hr;
}