Compartir a través de

Función StorPortInitializeWorker (storport.h)

  • Artículo

Crea un nuevo elemento de trabajo de Storport que se ejecuta en un subproceso de trabajo del sistema.

Sintaxis

ULONG StorPortInitializeWorker(
  [in]  PVOID HwDeviceExtension,
  [out] PVOID *Worker
);

Parámetros

[in] HwDeviceExtension

Puntero a la extensión de dispositivo de hardware para el adaptador de bus host (HBA).

[out] Worker

Puntero a un búfer opaco que contiene información de contexto para el elemento de trabajo.

Valor devuelto

La rutina StorPortInitializeWorker devuelve uno de estos códigos de estado:

Código devuelto Descripción
STOR_STATUS_INVALID_IRQL
 > DISPATCH_LEVEL irQL actual.
STOR_STATUS_INVALID_PARAMETER
 HwDeviceExtension o Worker es NULL.
STOR_STATUS_INSUFFICIENT_RESOURCES
 Hay recursos insuficientes disponibles para inicializar el contexto del elemento de trabajo.
STOR_STATUS_SUCCESS
 El elemento de trabajo se inicializó correctamente.

Comentarios

El contexto del elemento de trabajo devuelto en el parámetro Worker por StorPortInitializeWorker se usa en futuras llamadas a StorPortQueueWorkItem o StorPortFreeWorker.

Si la minipuerto usa el elemento de trabajo durante el procesamiento de E/S, se recomienda llamar a StorPortInitializeWorker durante la función HwStorFindAdapter de la miniporte para asegurarse de que los recursos estén disponibles cuando sea necesario.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows 8 y versiones posteriores de Windows.
Plataforma de destino Universal
Encabezado storport.h (incluya Storport.h)
IRQL <= DISPATCH_LEVEL

Consulte también

HwStorFindAdapter

StorPortFreeWorker

StorPortQueueWorkItem