Funciones de depuración de espera

[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.

Microsoft DirectShow proporciona varias funciones para depurar esperas infinitas.

En las compilaciones comerciales, las funciones DbgWaitForMultipleObjects y DbgWaitForSingleObject funcionan como sus homólogos de la API de Windows, WaitForMultipleObjects y WaitForSingleObject, con intervalos de tiempo de espera infinitos.

En las compilaciones de depuración, estas funciones usan un valor de tiempo de espera global. Si el tiempo de espera expira, la función desencadena una aserción. La siguiente clave del Registro especifica el valor de tiempo de espera, en milisegundos:

HKEY_LOCAL_MACHINE\<DebugRoot>\<Nombre> del módulo\TIMEOUT

donde <DebugRoot> es la ruta de acceso del Registro descrita en el tema Depurar funciones de salida.

Si la clave no existe, el valor de tiempo de espera predeterminado es INFINITE. Puede usar la función DbgSetWaitTimeout para invalidar la entrada del Registro.

Función	Descripción
DbgSetWaitTimeout	Establece el valor de tiempo de espera de depuración.
DbgWaitForMultipleObjects	Espera a que se señalen todos (o todos) de los objetos especificados.
DbgWaitForSingleObject	Espera a que se señale un objeto.