Pin Property Set

  • Article

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La 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 pin retourne la catégorie de broche d’une broche 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 jeu 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 de broches 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 Broche de capture.
PIN_CATEGORY_CC Épingle fournissant des données de sous-titrage à partir de la ligne 21.
PIN_CATEGORY_EDS Broche fournissant des services de données étendus (ligne 21, champs pairs).
PIN_CATEGORY_NABTS Épingler fournissant des données standard de vidéotexte nord-américain.
PIN_CATEGORY_PREVIEW Épingle d’aperçu.
PIN_CATEGORY_STILL Épingle qui fournit une image fixe. La broche de capture du filtre doit être connectée avant que la broche d’image fixe ne soit connectée.
PIN_CATEGORY_TELETEXT Épingle fournissant le télétexte (une variante de sous-titrage).
PIN_CATEGORY_TIMECODE Épingle fournissant des données de timecode.
PIN_CATEGORY_VBI Broche fournissant des données d’intervalle de remplissage vertical.
PIN_CATEGORY_VIDEOPORT Broche de sortie vidéo à connecter à la broche d’entrée zéro sur le mélangeur de superposition.
PIN_CATEGORY_VIDEOPORT_VBI Épingler à connecter à l’allocateur Surface VBI, le filtre d’allocation de surface VBI nécessaire pour allouer la mémoire vidéo appropriée pour des éléments tels que les superpositions 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 de découpage matériel

 

Cette propriété est en lecture seule.

Exemple de code

Le code suivant montre comment case activée 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;
}

Notes

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

 

Spécifications des broches pour les filtres de capture

Ensembles de propriétés

Utilisation des catégories de broches