Méthode CPullPin.Connect
[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.]
La Connect méthode termine une connexion à la broche de sortie.
Syntaxe
HRESULT Connect(
IUnknown *pUnk,
IMemAllocator *pAlloc,
BOOL bSync
);
Paramètres
-
Punk
-
Pointeur vers l’interface IUnknown de la broche de sortie.
-
pAlloc
-
Pointeur vers l’interface IMemAllocator de l’attribut préféré de la broche d’entrée, ou NULL.
-
bSync
-
Valeur booléenne qui spécifie s’il faut utiliser des lectures synchrones. Si la valeur EST TRUE, la broche effectue des opérations de lecture synchrone sur la broche de sortie. Si la valeur est FALSE, le code pin effectue des demandes de lecture asynchrones.
Valeur renvoyée
Retourne un HRESULT. Les valeurs possibles sont les suivantes.
| Code de retour | Description |
|---|---|
|
Opération réussie. |
|
La broche d’entrée est déjà connectée. |
|
La broche de sortie n’expose pas IAsyncReader. |
Notes
Appelez cette méthode pendant le processus de connexion de la broche d’entrée. Si la méthode échoue, la connexion doit échouer.
Cette méthode interroge la broche de sortie pour l’interface IAsyncReader . En cas de réussite, il appelle CPullPin::D ecideAllocator pour négocier l’allocateur pour la connexion. Si votre broche d’entrée a un attribut préféré, spécifiez-le dans le paramètre pAlloc ; la méthode DecideAllocator transmet ce pointeur à la méthode IAsyncReader::RequestAllocator de la broche de sortie. Sinon, définissez pAlloc sur NULL.
Si la valeur de bSync est TRUE, l’objet CPullPin effectue des demandes de lecture synchrones, en appelant le code IAsyncReader::SyncReadAligned de la broche de sortie. Sinon, il appelle la méthode IAsyncReader::Request pour effectuer des demandes de lecture qui se chevauchent.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|