Process.WaitForInputIdle (Método) (Int32) (System.Diagnostics)

WaitForInputIdle (Método) (Int32)

Encender vista de ancho de banda bajo

Contraer todo

Filtro de lenguage

Esta página es específica de

Microsoft Visual Studio 2008/.NET Framework 3.5

Hay además otras versiones disponibles para:

Biblioteca de clases de .NET Framework

Process..::.WaitForInputIdle (Método) (Int32)

Actualización: noviembre 2007

Hace que el componente Process espere a que el proceso asociado entre en estado de inactividad durante el número de milisegundos especificado. Esta sobrecarga sólo se aplica a los procesos que tengan una interfaz de usuario y, por tanto, un bucle de mensajes.

Espacio de nombres: System.Diagnostics
Ensamblado: System (en System.dll)

Sintaxis

Visual Basic (Declaración)

Public Function WaitForInputIdle ( _
    milliseconds As Integer _
) As Boolean

Visual Basic (Uso)

Dim instance As Process
Dim milliseconds As Integer
Dim returnValue As Boolean

returnValue = instance.WaitForInputIdle(milliseconds)

public bool WaitForInputIdle(
    int milliseconds
)

Visual C++

public:
bool WaitForInputIdle(
    int milliseconds
)

public boolean WaitForInputIdle(
    int milliseconds
)

JScript

public function WaitForInputIdle(
    milliseconds : int
) : boolean

Parámetros

milliseconds: Tipo: System..::.Int32
Valor de 1 para MaxValue que especifica el tiempo, en milisegundos, que se debe esperar para que el proceso asociado esté inactivo. El valor 0 especifica una devolución inmediata, y el valor -1 especifica una espera infinita.

Valor devuelto

Tipo: System..::.Boolean
Es true si el proceso asociado ha alcanzado el estado de inactividad; de lo contrario, es false.

Excepciones

Excepción	Condición
InvalidOperationException	Se ha producido un error desconocido. El proceso no pudo entrar en estado de inactividad.

Comentarios

Hay que utilizar WaitForInputIdle(Int32) para hacer que el procesamiento de una aplicación determinada se detenga hasta que el bucle de mensajes haya regresado al estado de inactividad. Cuando se está ejecutando un proceso que tiene una interfaz de usuario, el bucle de mensajes se ejecuta cada vez que el sistema operativo envía un mensaje de Windows al proceso. A continuación, el proceso regresa al bucle de mensajes. Se dice que un proceso se encuentra en estado de inactividad cuando está esperando mensajes en un bucle de mensajes. Este estado puede ser útil, por ejemplo, si la aplicación necesita esperar a que un proceso que se está iniciando termine de crear la ventana principal antes de que la aplicación se comunique con dicha ventana.

Si un proceso no tiene un bucle de mensajes, el método WaitForInputIdle(Int32) devuelve false inmediatamente.

La sobrecarga de WaitForInputIdle(Int32) indica al componente Process que espere durante una cantidad de tiempo determinada a que el proceso pase a estar inactivo en el bucle de mensajes. Si el proceso asociado no pasa a estar inactivo cuando ha terminado el intervalo de tiempo porque el bucle todavía está procesando mensajes, se devuelve false al procedimiento que realiza la llamada.

Para obtener más información sobre la forma de controlar eventos, vea Utilizar eventos.

Permisos

LinkDemand
para que haya plena confianza para el llamador inmediato. Este miembro no puede ser utilizado por código de confianza parcial.

Plataformas

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Información de versión