Verwenden der Streampriorisierung

[Das dieser Seite zugeordnete Feature Windows Media Format 11 SDK ist ein Legacyfeature. Es wurde von Source Reader und Sink Writer abgelöst. Source Reader und Sink Writer wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit quellleser und Senkenschreiber anstelle des Windows Media Format 11 SDK verwendet. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Mit der Streampriorisierung haben Sie mehr Kontrolle über die Wiedergabe von Inhalten, indem Sie die Prioritätsreihenfolge für die Streams in einem Profil angeben können. Wenn der Reader und der Streamingserver während der Wiedergabe auf eine Bandbreitenknappheit stoßen, müssen die Beispiele möglicherweise gelöscht werden, um eine unterbrechungsfreie Wiedergabe zu ermöglichen. Wenn Sie eine Prioritätsreihenfolge mit einem Streampriorisierungsobjekt im Profil angeben, werden die Beispiele zuerst aus den Streams mit der niedrigsten Priorität gelöscht.

Im Gegensatz zu Bandbreitenfreigabe- und gegenseitigen Ausschlussobjekten verwendet ein Streampriorisierungsobjekt nicht die IWMStreamList-Schnittstelle , um die Liste der Datenströme nachzuverfolgen. Stattdessen müssen Sie ein Array von WM_STREAM_PRIORITY_RECORD Strukturen verwenden. Die Strukturen müssen im Array in absteigender Reihenfolge der Priorität organisiert werden. Zusätzlich zum Speichern einer Datenstromnummer ermöglicht die Streamprioritätsstruktur auch die Angabe, ob ein Stream obligatorisch ist. Obligatorische Streams werden unabhängig von ihrer Position in der Liste nicht gelöscht.

Der folgende Beispielcode zeigt, wie Sie eine Streampriorisierung in ein Profil einschließen. Dieses Profil ist für eine Präsenzpräsentation mit einem Audiostream des Vortragenden, einem Videostream des Dozenten und einem Videostream, der die Präsentationsfolien erfasst. Der Audiodatenstrom ist der wichtigste und wird obligatorisch sein. Die Präsentationsfolien haben die niedrigste Priorität, da das Bild ziemlich konstant ist, sodass ein paar Frames, die hier und da verloren gehen, keinen großen Unterschied machen.

IWMProfileManager*       pProfileMgr = NULL;
IWMProfile*              pProfileTmp = NULL;
IWMProfile3*             pProfile    = NULL;
IWMStreamPrioritization* pPriority   = NULL;

WM_STREAM_PRIORITY_RECORD StreamArray[3];
HRESULT hr = S_OK;

// Initialize COM.
hr = CoInitialize(NULL);

// Create a profile manager object.
hr = WMCreateProfileManager(&pProfileMgr);

// Create an empty profile.
hr = pProfileMgr->CreateEmptyProfile(WMT_VER_9_0, &pProfileTmp)

// Get the IWMProfile3 for the new profile, then release the old one.
hr = pProfileTmp->QueryInterface(IID_IWMProfile3, (void**)&pProfile);
pProfileTmp->Release();
pProfileTmp = NULL;

// Give the new profile a name and description.
hr = pProfile->SetName(L"Prioritization_Example");
hr = pProfile->SetDescription(L"Only for use with example code.");

// Create the first stream.
hr = pProfile->CreateNewStream(WMMEDIATYPE_Audio, &pStream);

// TODO: configure the stream as needed for the scenario.

// Set the stream number.
hr = pStream->SetStreamNumber(1);

// Give the stream a name for clarity.
hr = pStream->SetStreamName(L"Lecturer_Audio");

// Include the new stream in the profile.
hr = pProfile->AddStream(pStream);

// Release the stream configuration interface.
pStream->Release();
pStream = NULL;

// Repeat for the other two streams.
hr = pProfile->CreateNewStream(WMMEDIATYPE_Video, &pStream);

// TODO: configure the stream as needed for the scenario.
hr = pStream->SetStreamNumber(2);
hr = pStream->SetStreamName(L"Lecturer_Video");
hr = pProfile->AddStream(pStream);
pStream->Release();
pStream = NULL;

hr = pProfile->CreateNewStream(WMMEDIATYPE_Video, &pStream);

// TODO: configure the stream as needed for the scenario.
hr = pStream->SetStreamNumber(3);
hr = pStream->SetStreamName(L"Slide_Video");
hr = pProfile->AddStream(pStream);
pStream->Release();
pStream = NULL;

// Create a stream prioritization object.
hr = pProfile->CreateNewStreamPrioritization(&pPriority);

// Fill the array with data.
StreamArray[0].wStreamNum = 1;
StreamArray[0].fMandatory = TRUE;

StreamArray[1].wStreamNum = 2;
StreamArray[1].fMandatory = FALSE;

StreamArray[2].wStreamNum = 3;
StreamArray[2].fMandatory = FALSE;

// Assign the stream array to the stream prioritization object.
hr = pPriority->SetPriorityRecords(StreamArray, 3);

// Add the stream prioritization to the profile.
hr = pProfile->SetStreamPrioritization(pPriority);

// Release the stream prioritization object.
pPriority->Release();
pPriority = NULL;

// TODO: Save the profile to a string, and save the string to a file.
// For more information, see To Save a Custom Profile.

// Release the remaining interfaces.
pProfile->Release();
pProfile = NULL;

pProfileMgr->Release();
pProfileMgr = NULL;

Zugehörige Themen

Arbeiten mit Profilen