Partager via


Pin, propriété Set

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngineet audio/vidéo capture dans 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 capture audio/vidéo dans Media Foundation au lieu de directShow, 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.]

Le jeu de propriétés d’épingle retourne la catégorie d’épingle d’une épingle sur un filtre. La catégorie est définie par le filtre lorsqu’il crée l’épingle ; la catégorie indique le type de données que la broche est remise ou reçoit par cette broche.

Étiquette Valeur
GUID de l’ensemble de propriétés AMPROPSETID_Pin

 

ID de propriété Description
AMPROPERTY_PIN_CATEGORY Spécifie la catégorie d’une broche.

 

DirectShow définit les catégories d’épingle suivantes dans le fichier d’en-tête Uuids.h.

GUID de catégorie Description
PIN_CATEGORY_ANALOGVIDEOIN Broche d’entrée du filtre de capture qui prend l’analogique et le numérise.
PIN_CATEGORY_CAPTURE Épingle de capture.
PIN_CATEGORY_CC Épingler la fourniture de données de sous-titrage à partir de la ligne 21.
PIN_CATEGORY_EDS Épingler la fourniture de services de données étendus (ligne 21, champs pairs).
PIN_CATEGORY_NABTS Épingler la fourniture de données Videotext Standard nord-américaines.
PIN_CATEGORY_PREVIEW Épingle d’aperçu.
PIN_CATEGORY_STILL Épingler qui fournit une image toujours. La broche de capture du filtre doit être connectée avant la connexion de la broche de l’image fixe.
PIN_CATEGORY_TELETEXT Épingler la télétexte (variante de sous-titrage).
PIN_CATEGORY_TIMECODE Épingler la fourniture de données de code temporel.
PIN_CATEGORY_VBI Épingler la fourniture de données d’intervalle d’videment vertical.
PIN_CATEGORY_VIDEOPORT Broche de sortie vidéo à connecter à la broche d’entrée zéro sur le mélangeur overlay.
PIN_CATEGORY_VIDEOPORT_VBI Épingler pour être connecté au VBI Surface Allocator, le filtre d’allocateur de surface VBI nécessaire pour allouer la mémoire vidéo correcte pour les éléments tels que les superpositions de sous-titrage de sous-titres dans les scénarios où un port vidéo est utilisé. Les scénarios PCI, IEEE 1394 et USB n’utilisent pas ce filtre.
PINNAME_VIDEO_CC_CAPTURE Broche de sous-titrage du matériel

 

Cette propriété est en lecture seule.

Exemple de code

Le code suivant montre comment vérifier si une broche prend en charge ce jeu de propriétés et, le cas échéant, comment obtenir la catégorie de broche :

HRESULT GetPinCategory(IPin *pPin, GUID *pPinCategory)
{
    IKsPropertySet *pKs = NULL;

    HRESULT hr = pPin->QueryInterface(IID_PPV_ARGS(&pKs));
    if (FAILED(hr))
    {
        return hr;
    }

    // Try to retrieve the pin category.
    DWORD cbReturned = 0;
    hr = pKs->Get(AMPROPSETID_Pin, AMPROPERTY_PIN_CATEGORY, NULL, 0, 
        pPinCategory, sizeof(GUID), &cbReturned);
    
    // If this succeeded, pPinCategory now contains the category GUID.

    SafeRelease(&pKs);
    return hr;
}

Note

Cet exemple utilise la fonction SafeRelease pour libérer des pointeurs d’interface.

 

Exigences relatives aux broches pour les filtres de capture

jeux de propriétés

utiliser des catégories de broches