簡報描述項

發行項
06/13/2023

簡報是一組共用一般簡報時間的相關媒體串流。例如，簡報可能包含電影中的音訊和視訊串流。 簡報描述元是物件，其中包含特定簡報的描述。簡報描述項是用來設定媒體來源和某些媒體接收。

每個簡報描述元都包含一或多個 資料流程描述元的清單。這些描述簡報中的資料流程。資料流程可以選取或取消選取。只有選取的資料流程會產生資料。取消選取的資料流程不是使用中，而且不會產生任何資料。每個資料流程描述項都有 媒體類型處理常式，可用來變更資料流程的媒體類型或取得資料流程目前的媒體類型。 (如需媒體類型的詳細資訊，請參閱媒體類型.)

下表顯示每個物件公開的主要介面。

Object	介面
簡報描述元	IMFPresentationDescriptor
資料流程描述項	IMFStreamDescriptor
媒體類型處理常式	IMFMediaTypeHandler

媒體來源簡報

每個媒體來源都會提供描述來源預設組態的簡報描述項。在預設組態中，至少會選取一個資料流程，而且每個選取的資料流程都有媒體類型。若要取得簡報描述元，請呼叫 IMFMediaSource：：CreatePresentationDescriptor。方法會傳回 IMFPresentationDescriptor 指標。

您可以修改來源的簡報描述元，以選取一組不同的資料流程。除非媒體來源停止，否則請勿修改簡報描述項。當您呼叫 IMFMediaSource：：Start 以啟動來源時，會套用變更。

若要取得資料流程數目，請呼叫 IMFPresentationDescriptor：：GetStreamDescriptorCount。若要取得資料流程的資料流程描述元，請呼叫 IMFPresentationDescriptor：：GetStreamDescriptorByIndex ，並傳入資料流程的索引。資料流程會從零編制索引。 GetStreamDescriptorByIndex方法會傳回IMFStreamDescriptor指標。它也會傳回 Boolean 旗標，指出是否已選取資料流程。如果選取資料流程，媒體來源會產生該資料流程的資料。否則，來源不會產生該資料流程的任何資料。若要選取資料流程，請使用資料流程的索引呼叫 IMFPresentationDescriptor：：SelectStream 。若要取消選取資料流程，請呼叫 IMFPresentationDescriptor：:D eselectStream。

下列程式碼示範如何從媒體來源取得簡報描述項，並列舉資料流程。

HRESULT hr = S_OK;
DWORD cStreams = 0;
BOOL  fSelected = FALSE;

IMFPresentationDescriptor *pPresentation = NULL;
IMFStreamDescriptor *pStreamDesc = NULL;

hr = pSource->CreatePresentationDescriptor(&pPresentation);

if (SUCCEEDED(hr))
{
    hr = pPresentation->GetStreamDescriptorCount(&cStreams);
}

if (SUCCEEDED(hr))
{
    for (DWORD iStream = 0; iStream < cStreams; iStream++)
    {
        hr = pPresentation->GetStreamDescriptorByIndex(
            iStream, &fSelected, &pStreamDesc);

        if (FAILED(hr))
        {
            break;
        }

        /*  Use the stream descriptor. (Not shown.) */

        SAFE_RELEASE(pStreamDesc);
    }
}
SAFE_RELEASE(pPresentation);
SAFE_RELEASE(pStreamDesc);

媒體類型處理常式

若要變更資料流程的媒體類型或取得資料流程目前的媒體類型，請使用資料流程描述元的媒體類型處理常式。呼叫 IMFStreamDescriptor：：GetMediaTypeHandler 以取得媒體類型處理常式。這個方法會傳回 IMFMediaTypeHandler 指標。

如果您只想要知道資料流程中的資料類型，例如音訊或視訊，請呼叫 IMFMediaTypeHandler：：GetMajorType。這個方法會傳回主要媒體類型的 GUID。例如，播放應用程式通常會將音訊資料流程連接到音訊轉譯器，並將視訊串流連接到視訊轉譯器。如果您使用媒體會話或拓撲載入器來建置拓撲，主要類型 GUID 可能是您唯一需要的格式資訊。

如果您的應用程式需要目前格式的詳細資訊，請呼叫 IMFMediaTypeHandler：：GetCurrentMediaType。這個方法會傳回媒體類型 之 IMFMediaType 介面的指標。使用此介面來取得格式的詳細資料。

媒體類型處理常式也包含資料流程支援的媒體類型清單。若要取得清單的大小，請呼叫 IMFMediaTypeHandler：：GetMediaTypeCount。若要從清單中取得媒體類型，請使用媒體類型的索引呼叫 IMFMediaTypeHandler：：GetMediaTypeByIndex 。媒體類型會以喜好設定的近似順序傳回。例如，針對音訊格式，較佳的取樣率優先于較低的取樣率。不過，沒有規範排序的明確規則，因此您應該將其視為指導方針。

支援的型別清單可能不會包含資料流程支援的每個可能媒體類型。若要測試是否支援特定媒體類型，請呼叫 IMFMediaTypeHandler：：IsMediaTypeSupported。若要設定媒體類型，請呼叫 IMFMediaTypeHandler：：SetCurrentMediaType。如果方法成功，資料流程將包含符合指定格式的資料。 SetCurrentMediaType方法不會變更慣用類型的清單。

下列程式碼示範如何取得媒體類型處理常式、列舉慣用媒體類型，以及設定媒體類型。此範例假設應用程式有一些演算法，但此處未顯示用於選取媒體類型。細節將大幅取決於您的應用程式。

HRESULT hr = S_OK;
DWORD cTypes = 0;
BOOL  bTypeOK = FALSE;

IMFMediaTypeHandler *pHandler = NULL;
IMFMediaType *pMediaType = NULL;

hr = pStreamDesc->GetMediaTypeHandler(&pHandler);

if (SUCCEEDED(hr))
{
    hr = pHandler->GetMediaTypeCount(&cTypes);
}

if (SUCCEEDED(hr))
{
    for (DWORD iType = 0; iType < cTypes; iType++)
    {   
        hr = pHandler->GetMediaTypeByIndex(iType, &pMediaType);

        if (FAILED(hr))
        {
            break;
        }

        /* Examine the media type. (Not shown.)  */

        /* If this media type is acceptable, set the media type. */

        if (bTypeOK)
        {
            hr = pHandler->SetCurrentMediaType(pMediaType);
            break;
        }

        SAFE_RELEASE(pMediaType);
    }
}    

SAFE_RELEASE(pMediaType);
SAFE_RELEASE(pHandler);

媒體來源
媒體基礎平臺 API

共用方式為

簡報描述項

媒體來源簡報

媒體類型處理常式

意見反應

其他資源

共用方式為

簡報描述項

媒體來源簡報

媒體類型處理常式

相關主題

意見反應

其他資源