CBaseInputPin.ReceiveMultiple, méthode
[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.]
La ReceiveMultiple méthode reçoit un tableau d’exemples. Cette méthode implémente la méthode IMemInputPin::ReceiveMultiple .
Syntaxe
HRESULT ReceiveMultiple(
IMediaSample **pSamples,
long nSamples,
long *nSamplesProcessed
);
Paramètres
-
pSamples
-
Adresse d’un tableau de pointeurs IMediaSample , de taille nSamples.
-
nSamples
-
Nombre d’échantillons à traiter.
-
nSamplesProcessed
-
Pointeur vers une variable qui reçoit le nombre d’échantillons traités.
Valeur renvoyée
Retourne une valeur HRESULT . Les valeurs possibles incluent celles répertoriées dans le tableau suivant.
| Code de retour | Description |
|---|---|
|
Opération réussie. |
|
Broche est en cours de vidage ; l’échantillon a été rejeté. |
|
Argument pointeur NULL . |
|
Type de média non valide. |
|
Une erreur d’exécution s’est produite. |
|
L’épingle est arrêtée. |
Notes
Cette méthode se comporte comme la méthode CBaseInputPin::Receive , mais reçoit un tableau d’exemples. Dans la classe de base, la méthode effectue une boucle dans le tableau et appelle Receive avec chaque exemple. Remplacez cette fonction si votre filtre peut traiter des lots d’échantillons plus efficacement que de les traiter un par un.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|