Utilisation de l’exclusion mutuelle à débit binaire multiple
[La fonctionnalité associée à cette page, le Kit de développement logiciel (SDK) Windows Media Format 11, est une fonctionnalité héritée. Il a été remplacé par lecteur source et enregistreur récepteur. Le lecteur source et l’enregistreur récepteur ont été optimisés pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise le lecteur source et l’enregistreur récepteur au lieu du Kit de développement logiciel (SDK) Windows Media Format 11, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]
L’exclusion mutuelle à débit multiple (MBR) est utile lorsque vous souhaitez encoder du contenu pour divers scénarios de lecture. Une sortie vidéo MBR se compose d’une seule entrée encodée plusieurs fois, chacune avec des paramètres de débit binaire différents. Lorsqu’un fichier avec encodage MBR est lu, le lecteur détermine le flux à utiliser en fonction de la bande passante disponible.
Le Kit de développement logiciel (SDK) au format Windows Media prend en charge l’encodage MBR pour les flux vidéo et audio. En outre, vous pouvez créer un type spécial d’encodage MBR appelé encodage MBR de taille vidéo multiple. La vidéo MBR de plusieurs tailles vidéo fonctionne de manière identique à la vidéo MBR normale, sauf que vous pouvez spécifier différentes tailles d’image pour les flux vidéo dans l’exclusion mutuelle.
L’exemple suivant montre comment configurer un profil pour une vidéo MBR avec plusieurs tailles de vidéo. Il crée un profil avec trois flux vidéo de débit et de tailles variables, et les inclut dans un objet d’exclusion mutuelle.
IWMProfileManager* pProfileMgr = NULL;
IWMProfile* pProfile = NULL;
IWMMutualExclusion* pMutex = NULL;
IWMStreamConfig* pStream = NULL;
IWMMediaProps* pMediaProps = NULL;
WM_MEDIA_TYPE* pMediaType = NULL;
DWORD cbMediaType = 0;
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, &pProfile);
// Give the new profile a name and description.
hr = pProfile->SetName(L"MBR_Video_3_Stream_test");
hr = pProfile->SetDescription(L"Only for use with example code.");
// Create the first stream.
hr = pProfile->CreateNewStream(WMMEDIATYPE_Video, &pStream);
// Get the media properties interface for the new stream.
hr = pStream->QueryInterface(IID_IWMMediaProps, (void**)&pMediaProps);
// Get the media-type structure.
// First, get the size of the media-type structure.
hr = pMediaProps->GetMediaType(NULL, &cbMediaType);
// Allocate memory for the structure based on the retrieved size.
pMediaType = (WM_MEDIA_TYPE*) new BYTE[cbMediaType];
// Retrieve the media-type structure.
hr = pMediaProps->GetMediaType(pMediaType, &cbMediaType);
// Change the video size to 640 x 480.
pMediaType->pbFormat->bmiHeader.biWidth = 640;
pMediaType->pbFormat->bmiHeader.biHeight = 480;
// Replace the WM_MEDIA_TYPE in the profile with the one just changed.
hr = pMediaProps->SetMediaType(pMediaType);
// Release the media properties interface and delete the structure.
pMediaProps->Release();
pMediaProps = NULL;
delete[] pMediaType;
pMediaType = NULL;
// Set the bit rate to 200.
hr = pStream->SetBitrate(200000);
// Set the stream number.
hr = pStream->SetStreamNumber(1);
// Include the new stream in the profile.
hr = pProfile->AddStream(pStream);
// Release the stream configuration interface.
pStream->Release();
pStream = NULL;
// For the remaining two streams, leave the video at its default size of
// 320 x 240 <entity type="ndash"/>- just change the bit rates.
// Repeat for a 100K stream.
hr = pProfile->CreateNewStream(WMMEDIATYPE_Video, &pStream);
hr = pStream->SetBitrate(100000);
hr = pStream->SetStreamNumber(2);
hr = pProfile->AddStream(pStream);
pStream->Release();
pStream = NULL;
// Repeat for a 56K stream.
hr = pProfile->CreateNewStream(WMMEDIATYPE_Video, &pStream);
hr = pStream->SetBitrate(56000);
hr = pStream->SetStreamNumber(3);
hr = pProfile->AddStream(pStream);
pStream->Release();
pStream = NULL;
// Now that we have three streams, create a mutual exclusion object.
hr = pProfile->CreateNewMutualExclusion(&pMutex);
// Add the three streams to the mutual exclusion.
hr = pMutex->AddStream(1);
hr = pMutex->AddStream(2);
hr = pMutex->AddStream(3);
// Configure the mutual exclusion for MBR video.
hr = pMutex->SetType(CLSID_WMMUTEX_Bitrate);
// Add the mutual exclusion to the profile.
hr = pProfile->AddMutualExclusion(pMutex);
// Release the mutual exclusion object.
pMutex->Release();
pMutex = 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 remaining interfaces.
pProfile->Release();
pProfile = NULL;
pProfileMgr->Release();
pProfileMgr = NULL;
Rubriques connexes