Función StorPortWaitForSingleObject (storport.h)

Artículo
08/07/2023

Un minipuerto puede llamar a la función StorPortWaitForSingleObject para colocar el subproceso actual en un estado de espera hasta que el objeto distribuidor especificado esté establecido en estado señalado o, opcionalmente, agote el tiempo de espera.

Sintaxis

ULONG StorPortWaitForSingleObject(
  PVOID          HwDeviceExtension,
  PVOID          Object,
  BOOLEAN        Alertable,
  PLARGE_INTEGER Timeout
);

Parámetros

HwDeviceExtension

Puntero a la extensión del dispositivo del minipuerto de almacenamiento.

Object

Puntero al objeto distribuidor inicializado (evento, exclusión mutua, semáforo, subproceso o temporizador).

Alertable

El valor booleano establece TRUE si la espera es alertable y FALSE en caso contrario.

Timeout

Puntero al valor de tiempo de espera que especifica el tiempo absoluto o relativo, en unidades de 100 nanosegundos, en las que se completará la espera.

Un valor positivo especifica una hora absoluta, relativa al 1 de enero de 1601. Un valor negativo especifica un intervalo relativo a la hora actual. Los tiempos de expiración absolutos realizan un seguimiento de los cambios en la hora del sistema; los tiempos de expiración relativos no se ven afectados por los cambios de hora del sistema.

Si Timeout = 0, la rutina devuelve sin esperar. Si el minipuerto proporciona un puntero NULL, la rutina espera indefinidamente hasta que el objeto distribuidor se establece en el estado señalado. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

Valor devuelto

StorPortSetEvent devuelve un código de estado como uno de los siguientes:

Código devuelto	Descripción
STOR_STATUS_INVALID_PARAMETER	Uno o varios de los parámetros no son válidos.
STOR_STATUS_SUCCESS	El evento ETW se registró correctamente.
STOR_STATUS_UNSUCCESSFUL	Error en la operación.

Comentarios

Consulte KeWaitForSingleObject para obtener más detalles.

Los autores de llamadas de StorportWaitForSingleObject deben ejecutarse en IRQL <= DISPATCH_LEVEL. Sin embargo, si Timeout = NULL o Timeout != 0, el autor de la llamada debe ejecutarse en IRQL <= APC_LEVEL y en un contexto de subproceso nobitrario. (Si Timeout != NULL y Timeout = 0, el autor de la llamada debe ejecutarse en IRQL <= DISPATCH_LEVEL).