Método CDynamicOutputPin.AsynchronousBlockOutputPin
[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.
El AsynchronousBlockOutputPin método bloquea el pin. El método podría devolverse antes de que se bloquee el pin.
Sintaxis
HRESULT AsynchronousBlockOutputPin(
HANDLE hNotifyCallerPinBlockedEvent
);
Parámetros
-
hNotifyCallerPinBlockedEvent
-
Identificador para un evento. El evento se señala cuando se bloquea el pin de salida o si el autor de la llamada cancela la operación de bloqueo.
Valor devuelto
Devuelve un valor HRESULT . Entre los valores posibles se incluyen los que se muestran en la tabla siguiente.
| Código devuelto | Descripción |
|---|---|
|
Correcto. |
|
El pin ya está bloqueado en otro subproceso. |
|
El pin ya está bloqueado en el subproceso que realiza la llamada. |
Observaciones
No llame a este método desde el subproceso de streaming.
Si ningún subproceso de streaming usa el pin, este método bloquea inmediatamente la patilla. De lo contrario, establece el estado de anclaje en "pendiente" y devuelve. Cuando se completa la operación de streaming, el subproceso de streaming llama al método CDynamicOutputPin::StopUsingOutputPin , que bloquea el pin y señala el evento hNotifyCallerPinBlockedEvent . Para cancelar un bloque pendiente, llame al método CDynamicOutputPin::UnblockOutputPin .
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
| Biblioteca |
|