Constructeur CBasePin.CBasePin

[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.]

Méthode du constructeur.

Syntaxe

CBasePin(
   TCHAR         *pObjectName,
   CBaseFilter   *pFilter,
   CCritSec      *pLock,
   HRESULT       *phr,
   LPCWSTR       pName,
   PIN_DIRECTION dir
);

Paramètres

pObjectName

Chaîne contenant le nom de débogage de l’objet. Pour plus d’informations, consultez CBaseObject.

pFilter

Pointeur vers le filtre qui a créé cette broche.

Plock

Pointeur vers un verrou CCritSec , utilisé pour sérialiser les modifications d’état. Il peut s’agir de la même section critique que le verrou de filtre , CBaseFilter::m_pLock.

Phr

Pointeur vers une variable qui reçoit une valeur HRESULT indiquant la réussite ou l’échec de la méthode. Initialisez la valeur à S_OK avant de créer l’objet . La valeur est modifiée uniquement si une erreur se produit.

pName

Chaîne de caractères larges contenant le nom de l’épingle. Pour plus d’informations, consultez CBasePin::QueryPinInfo.

dir

Membre de l’énumération PIN_DIRECTION spécifiant la direction de la broche.

Notes

La section critique spécifiée par pLock sérialise l’état de la broche, y compris son status de connexion, le choix de l’allocateur, le type de média et la status des opérations de vidage. N’utilisez pas cette section critique pour sérialiser les opérations de streaming. Pour plus d’informations, consultez Data Flow dans le graphe de filtres.

Un filtre peut créer des broches dans sa méthode de constructeur. À ce stade, le pointeur pFilter peut ne pas faire référence à un objet valide. Stockez le pointeur, mais ne le déréférencez pas à l’intérieur du constructeur de la broche.

Configuration requise

Voir aussi

CBasePin, classe