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.
Rubriques connexes
-
Exigences relatives aux broches pour les filtres de capture