Définition des propriétés de compression vidéo

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si 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.]

Les filtres de compression vidéo peuvent prendre en charge l’interface IAMVideoCompression sur leurs broches de sortie. Utilisez cette interface pour définir les propriétés de compression, telles que la fréquence d’images clés, le nombre d’images prédites (P) par image clé et la qualité de compression relative.

Tout d’abord, appelez la méthode IBaseFilter::EnumPins pour rechercher la broche de sortie du filtre, puis interrogez l’épingle pour l’interface. Certains filtres peuvent ne pas prendre en charge l’interface. D’autres peuvent exposer l’interface, mais ne prennent pas en charge toutes les propriétés de compression. Pour déterminer les propriétés prises en charge, appelez IAMVideoCompression::GetInfo. Cette méthode retourne plusieurs éléments d’informations :

• Un ensemble d’indicateurs de fonctionnalités
• Chaîne descriptive et chaîne de numéro de version
• Valeurs par défaut pour la fréquence d’images clés, la fréquence d’images P et la qualité (lorsqu’elles sont prises en charge)

La méthode a la syntaxe suivante :

hr = pCompress->GetInfo(pszVersion, &cbVersion, pszDesc, &cbDesc, 
         &lKeyFrame, &lPFrame, &dblQuality, &lCap);

Les paramètres pszVersion et pszDesc sont des mémoires tampons à caractères larges qui reçoivent la chaîne de version et la chaîne de description. Les paramètres cbVersion et cbDesc reçoivent les tailles de mémoire tampon requises en octets (et non en caractères). Les paramètres lKeyFrame, lPFrame et dblQuality reçoivent les valeurs par défaut pour la fréquence d’images clés, la fréquence d’images P et la qualité. La qualité est exprimée sous la forme d’un nombre à virgule flottante comprise entre 0,0 et 1,0. Le paramètre lCap reçoit un OR au niveau du bit des indicateurs de fonctionnalités, qui sont définis par le type énuméré CompressionCaps .

L’un de ces paramètres peut être NULL, auquel cas la méthode ignore ce paramètre. Par exemple, pour allouer des mémoires tampons pour les chaînes de version et de description, appelez d’abord la méthode avec NULL dans les premier et troisième paramètres. Utilisez les valeurs retournées pour cbVersion et cbDesc pour allouer les mémoires tampons, puis appelez à nouveau la méthode :

int cbVersion, cbDesc; // Size in bytes, not characters!
hr = pCompress->GetInfo(0, &cbVersion, 0, &cbDesc, 0, 0, 0, 0);
if (SUCCEEDED(hr))
{
    WCHAR *pszVersion = new WCHAR[cbVersion/2]; // Wide character = 2 bytes
    WCHAR *pszDesc = new WCHAR[cbDesc/2];
    hr = pCompress->GetInfo(pszVersion, 0, pszDesc, 0, 0, 0, 0, 0);
}

La valeur de lCap indique les autres méthodes IAMVideoCompression prises en charge par le filtre. Par exemple, si lCap contient l’indicateur CompressionCaps_CanKeyFrame, vous pouvez appeler IAMVideoCompression::get_KeyFrameRate pour obtenir la fréquence d’images clés et IAMVideoCompression::p ut_KeyFrameRate pour définir la fréquence d’images clés. Une valeur négative indique que le filtre utilisera la valeur par défaut, telle qu’obtenue à partir d’IAMVideoCompression::GetInfo. Par exemple :

if (lCap & CompressionCaps_CanKeyFrame)
{
    hr = pCompress->get_KeyFrameRate(&lKeyFrame);
    if (FAILED(hr) || lKeyFrame < 0)
    {
        lKeyFrame = lDefaultKeyFrame; // From GetInfo.
    }
}

L’exemple de code suivant tente de trouver l’interface IAMVideoCompression sur la broche de sortie. Si elle réussit, elle récupère les valeurs par défaut et réelles pour les propriétés de compression :

HRESULT hr = E_FAIL;
IEnumPins *pEnum = NULL;
IPin *pPin = NULL;
IAMVideoCompression *pCompress = NULL;

// Find the pin that supports IAMVideoCompression (if any).
pFilter->EnumPins(&pEnum);
while (S_OK == pEnum->Next(1, &pPin, NULL))
{
    hr = pPin->QueryInterface(IID_IAMVideoCompression, (void**)&pCompress);
    pPin->Release();
    if (SUCCEEDED(hr)) // Found the interface.
    {
        break;
    }
}
if (SUCCEEDED(hr)) 
{
    long lCap;                     // Capability flags
    long lKeyFrame, lPFrame;       // Real values
    double m_Quality;
    long lKeyFrameDef, lPFrameDef; // Default values
    double QualityDef;
    
    // Get default values and capabilities.
    hr = pCompress->GetInfo(0, 0, 0, 0, &KeyFrameDef, &lPFrameDef,
             &QualityDef, &lCap);
    if (SUCCEEDED(hr))
    {
        // Get actual values where possible.
        if (lCap & CompressionCaps_CanKeyFrame)
        {
            hr = pCompress->get_KeyFrameRate(&lKeyFrame);
            if (FAILED(hr) || lKeyFrame < 0)
                lKeyFrame = lKeyFrameDef;
        }
        if (lCap & CompressionCaps_CanBFrame)
        {
            hr = pCompress->get_PFramesPerKeyFrame(&lPFrame);
            if (FAILED(hr) || lPFrame < 0)
                lPFrame = lPFrameDef;
        }
        if (lCap & CompressionCaps_CanQuality)
        {
            hr = pCompress->get_Quality(&Quality);
            if (FAILED(hr) || Quality < 0)
                Quality = QualityDef;
        }
    }
}

Notes

Si vous utilisez l’interface ICaptureGraphBuilder2 pour générer votre graphe, vous pouvez obtenir l’interface IAMVideoCompression en appelant ICaptureGraphBuilder2::FindInterface, au lieu d’utiliser IBaseFilter::EnumPins. La méthode FindInterface est une méthode d’assistance qui recherche des filtres et des épingles dans le graphique pour une interface spécifiée.