Partager via


Méthode CDynamicOutputPin.AsynchroneBlockOutputPin

[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 AsynchronousBlockOutputPin méthode bloque l’épingle. La méthode peut retourner avant que l’épingle ne soit bloquée.

Syntaxe

HRESULT AsynchronousBlockOutputPin(
   HANDLE hNotifyCallerPinBlockedEvent
);

Paramètres

hNotifyCallerPinBlockedEvent

Handle vers un événement. L’événement est signalé lorsque la broche de sortie est bloquée ou si l’appelant annule l’opération de blocage.

Valeur renvoyée

Retourne une valeur HRESULT . Les valeurs possibles incluent celles indiquées dans le tableau suivant.

Code de retour Description
S_OK
Opération réussie.
VFW_E_PIN_ALREADY_BLOCKED
Le code pin est déjà bloqué sur un autre thread.
VFW_E_PIN_ALREADY_BLOCKED_ON_THIS_THREAD
Le code pin est déjà bloqué sur le thread appelant.

Notes

N’appelez pas cette méthode à partir du thread de streaming.

Si aucun thread de streaming n’utilise la broche, cette méthode bloque immédiatement la broche. Sinon, il définit l’status de broche sur « en attente » et retourne. Une fois l’opération de diffusion en continu terminée, le thread de diffusion en continu appelle la méthode CDynamicOutputPin::StopUsingOutputPin , qui bloque le code pin et signale l’événement hNotifyCallerPinBlockedEvent . Pour annuler un bloc en attente, appelez la méthode CDynamicOutputPin::UnblockOutputPin .

Configuration requise

Condition requise Valeur
En-tête
Amfilter.h (include Streams.h)
Bibliothèque
Strmbase.lib (builds de vente au détail) ;
Strmbasd.lib (builds de débogage)

Voir aussi

Classe CDynamicOutputPin