Función NdisMSleep (ndis.h)

Artículo
08/07/2023

La función NdisMSleep retrasa la ejecución del llamador durante un intervalo determinado en microsegundos.

Sintaxis

void NdisMSleep(
  [in] ULONG MicrosecondsToSleep
);

Parámetros

[in] MicrosecondsToSleep

Número de microsegundos que se van a retrasar.

Valor devuelto

None

Observaciones

Para el tiempo dado en el parámetro MicrosecondsToSleep , el subproceso de ejecución del autor de la llamada se coloca en un estado de espera, lo que permite que otros subprocesos realicen el trabajo en el procesador actual. Cuando expira el intervalo especificado, el autor de la llamada de NdisMSleep reanuda la ejecución.

Un controlador NDIS siempre debe llamar a NdisMSleep en preferencia a la función NdisStallExecution a menos que el controlador se ejecute en IRQL >= DISPATCH_LEVEL. NdisMSleep puede aceptar un intervalo de retraso mayor que NdisStallExecution, que nunca se debe llamar con un intervalo superior a 50 microsegundos. No llame a NdisMSleep con un tiempo de espera de más de 30 000 000 microsegundos (es decir, 30 segundos o medio minuto).

Los controladores de miniport pueden llamar a NdisMSleep desde su MiniportInitializeEx y, posiblemente, las funciones MiniportHaltEx cuando cualquiera de las funciones debe esperar a que se produzcan cambios de estado en la NIC antes de que esa función continúe con sus operaciones.

Tanto NdisMSleep como NdisStallExecution permiten que un controlador de miniporte especifique un retraso de forma coherente e independiente de la velocidad del reloj de la CPU del host. Ninguna de las funciones implica un objeto de temporizador como los usados por la función NdisSetTimerObject . La resolución del reloj del sistema host varía, por lo que los retrasos muy cortos pueden tardar ligeramente más tiempo que el autor de la llamada de NdisMSleep o NdisStallExecution especificado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Compatible con los controladores NDIS 6.0 y NDIS 5.1 (consulte NdisMSleep (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulte NdisMSleep (NDIS 5.1)).
Plataforma de destino	Universal
Encabezado	ndis.h (incluya Ndis.h)
Library	Ndis.lib
IRQL	< DISPATCH_LEVEL
Reglas de cumplimiento de DDI	Irql_Miniport_Driver_Function(ndis)