IMFSourceResolver

URL またはバイトストリームからメディアソースを作成します。

URL からメディアソースまたはバイトストリームを作成します。このメソッドは同期的です。

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

dwFlags パラメーターには、MF_RESOLUTION_MEDIASOURCE フラグまたは MF_RESOLUTION_BYTESTREAM フラグのいずれかを含める必要がありますが、両方を含めることはできません。

入力引数 dwFlags に MF_RESOLUTION_WRITE を設定することは、そのシナリオで必要な場合を除き、推奨されません。ほとんどのユースケースでは、メディアソースを書き込み機能付きで作成する必要はありません。書き込み機能付きでメディアソースを作成すると、書き込み機能なしで作成する場合よりも成功する可能性が低くなることがあります。これは、書き込み機能付きでメディアソースを作成する際に、URL が表すコンテンツに対してより厳格なチェックが行われる可能性があるためです。

ローカルファイルの場合は、ファイル名を pwszURL パラメーターに渡すことができます。file: スキームは必須ではありません。

Examples

//  Create a media source from a URL.
HRESULT CreateMediaSource(PCWSTR sURL, IMFMediaSource **ppSource)
{
    MF_OBJECT_TYPE ObjectType = MF_OBJECT_INVALID;

    IMFSourceResolver* pSourceResolver = NULL;
    IUnknown* pSource = NULL;

    // Create the source resolver.
    HRESULT hr = MFCreateSourceResolver(&pSourceResolver);
    if (FAILED(hr))
    {
        goto done;
    }

    // Use the source resolver to create the media source.

    // Note: For simplicity this sample uses the synchronous method to create 
    // the media source. However, creating a media source can take a noticeable
    // amount of time, especially for a network source. For a more responsive 
    // UI, use the asynchronous BeginCreateObjectFromURL method.

    hr = pSourceResolver->CreateObjectFromURL(
        sURL,                       // URL of the source.
        MF_RESOLUTION_MEDIASOURCE,  // Create a source object.
        NULL,                       // Optional property store.
        &ObjectType,        // Receives the created object type. 
        &pSource            // Receives a pointer to the media source.
        );
    if (FAILED(hr))
    {
        goto done;
    }

    // Get the IMFMediaSource interface from the media source.
    hr = pSource->QueryInterface(IID_PPV_ARGS(ppSource));

done:
    SafeRelease(&pSourceResolver);
    SafeRelease(&pSource);
    return hr;
}

バイトストリームからメディアソースを作成します。このメソッドは同期的です。

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

dwFlags パラメーターには MF_RESOLUTION_MEDIASOURCE フラグを含める必要があり、MF_RESOLUTION_BYTESTREAM フラグは含めないでください。

ソースリゾルバーは、URL のファイル名拡張子、またはバイトストリームの MIME タイプ(あるいはその両方)に基づいて、バイトストリームに対する 1 つ以上のバイトストリームハンドラーの検索を試みます。URL は省略可能な pwszURL パラメーターで指定し、MIME タイプはバイトストリームの MF_BYTESTREAM_CONTENT_TYPE 属性で指定できます。バイトストリームハンドラーは、Scheme Handlers and Byte-Stream Handlers で説明されているとおり、ファイル名拡張子または MIME タイプ、あるいはその両方によって登録されます。呼び出し元は、これらの値の少なくとも一方(可能であれば両方)を指定する必要があります。

• pwszURL パラメーターに URL を指定します。
• バイトストリームに MF_BYTESTREAM_CONTENT_TYPE 属性を設定して MIME タイプを指定します。(この属性は、バイトストリームの作成方法によっては、バイトストリームを作成した時点で既に設定されている場合があります。)

URL からメディアソースまたはバイトストリームを作成する非同期要求を開始します。

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

dwFlags パラメーターには、MF_RESOLUTION_MEDIASOURCE フラグまたは MF_RESOLUTION_BYTESTREAM フラグのいずれかを含める必要がありますが、両方を含めることはできません。

ローカルファイルの場合は、ファイル名を pwszURL パラメーターに渡すことができます。file: スキームは必須ではありません。

操作が完了すると、ソースリゾルバーは IMFAsyncCallback::Invoke メソッドを呼び出します。Invoke メソッドは、作成されたオブジェクトへのポインターを取得するために IMFSourceResolver::EndCreateObjectFromURL を呼び出す必要があります。

pProps パラメーターの使用方法は、メディアソースの実装によって異なります。

URL からオブジェクトを作成する非同期要求を完了します。(IMFSourceResolver.EndCreateObjectFromURL)

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

このメソッドは、アプリケーションの IMFAsyncCallback::Invoke メソッドの内部から呼び出してください。

バイトストリームからメディアソースを作成する非同期要求を開始します。(IMFSourceResolver.BeginCreateObjectFromByteStream)

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

dwFlags パラメーターには MF_RESOLUTION_MEDIASOURCE フラグを含める必要があり、MF_RESOLUTION_BYTESTREAM フラグは含めないでください。

ソースリゾルバーは、URL のファイル名拡張子、またはバイトストリームの MIME タイプ(あるいはその両方)に基づいて、バイトストリームに対する 1 つ以上のバイトストリームハンドラーの検索を試みます。URL は省略可能な pwszURL パラメーターで指定し、MIME タイプはバイトストリームの MF_BYTESTREAM_CONTENT_TYPE 属性で指定できます。バイトストリームハンドラーは、Scheme Handlers and Byte-Stream Handlers で説明されているとおり、ファイル名拡張子または MIME タイプ、あるいはその両方によって登録されます。呼び出し元は、これらの値の少なくとも一方を指定する必要があります。

操作が完了すると、ソースリゾルバーは IMFAsyncCallback::Invoke メソッドを呼び出します。Invoke メソッドは、メディアソースへのポインターを取得するために IMFSourceResolver::EndCreateObjectFromByteStream を呼び出す必要があります。

バイトストリームからメディアソースを作成する非同期要求を完了します。

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

このメソッドは、アプリケーションの IMFAsyncCallback::Invoke メソッドの内部から呼び出してください。

オブジェクトを作成する非同期要求をキャンセルします。

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

このメソッドを使用して、BeginCreateObjectFromByteStream または BeginCreateObjectFromURL への以前の呼び出しをキャンセルできます。ただし、これらのメソッドは非同期であるため、操作をキャンセルできる前に完了している場合があります。したがって、このメソッドを呼び出した後でも、コールバックが呼び出されることがあります。