Método CDynamicOutputPin.Block
[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 Block método bloquea o desbloquea el flujo de datos del pin. Este método implementa el método IPinFlowControl::Block .
Sintaxis
HRESULT Block(
DWORD dwBlockFlags,
HANDLE hEvent
);
Parámetros
-
dwBlockFlags
-
Marca que indica si se va a bloquear o desbloquear el pin. Debe ser uno de los siguientes valores:
Cero: desbloquee el flujo de datos desde la patilla.
AM_PIN_FLOW_CONTROL_BLOCK: bloquee el flujo de datos del pin.
-
hEvent
-
Identificador de un objeto de evento o NULL.
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 |
|---|---|
|
El pin ya está desbloqueado. |
|
Correcto. |
|
Argumento no válido. |
|
El pin ya está bloqueado en otro subproceso. |
|
El pin ya está bloqueado en el subproceso que realiza la llamada. |
Observaciones
Para obtener más información sobre este método, vea IPinFlowControl::Block. Internamente, este método llama a uno de los métodos protegidos siguientes:
- Block (asincrónico): CDynamicOutputPin::AsynchronousBlockOutputPin
- Block (sincrónico): CDynamicOutputPin::SynchronousBlockOutputPin
- Desbloquear: CDynamicOutputPin::UnblockOutputPin
El desbloqueo siempre se realiza de forma sincrónica.
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
| Biblioteca |
|