HW_RESET_BUS función de devolución de llamada (storport.h)

El controlador de puerto llama a la rutina HwStorResetBus para borrar las condiciones de error.

Sintaxis

HW_RESET_BUS HwResetBus;

BOOLEAN HwResetBus(
  PVOID DeviceExtension,
  ULONG PathId
)
{...}

Parámetros

DeviceExtension

Puntero al área de almacenamiento del controlador de minipuerto por HBA.

PathId

Identifica el bus SCSI que se va a restablecer.

Valor devuelto

Si el bus se restablece correctamente, HwStorResetBus devuelve TRUE.

Comentarios

El nombre HwStorResetBus es simplemente un marcador de posición. El prototipo real de esta rutina se define en Storport.h de la siguiente manera:

typedef
BOOLEAN
HW_RESET_BUS (
  _In_ PVOID  DeviceExtension,
  _In ULONG  PathId
  );

El controlador de puerto pausa todas las colas de E/S del dispositivo para el adaptador y, a continuación, llama a la rutina HwStorResetBus en IRQL DISPATCH_LEVEL después de adquirir el bloqueo de número StartIo. Un controlador de minipuerto es responsable de completar los SRB recibidos por HwStorStartIo para PathId durante esta rutina y establecer su estado en SRB_STATUS_BUS_RESET si es necesario.

Además del bloqueo de número StartIo que se toma y posteriormente se libera después de que HwStorResetBus devuelva, si la miniporte ha solicitado compatibilidad con varios canales a través de PERF_CONFIGURATION_DATA, se tomarán todos los tokens de canal y, al devolver la devolución de llamada, se liberará. Esto garantiza que no se envíe ninguna E/S a HwStorStartIo durante la fase de restablecimiento del bus.

Ejemplos

Para definir una función de devolución de llamada HwStorResetBus , primero debe proporcionar una declaración de función que identifique el tipo de función de devolución de llamada que está definiendo. Windows proporciona un conjunto de tipos de función de devolución de llamada para controladores. Declarar una función mediante los tipos de función de devolución de llamada ayuda a Code Analysis for Drivers, Static Driver Verifier (SDV) y otras herramientas de comprobación encuentran errores y es un requisito para escribir controladores para el sistema operativo Windows.

Por ejemplo, para definir una rutina de devolución de llamada HwStorResetBus denominada MyHwResetBus, use el tipo de HW_RESET_BUS como se muestra en este ejemplo de código:

HW_RESET_BUS MyHwResetBus;

A continuación, implemente la rutina de devolución de llamada de la siguiente manera:

_Use_decl_annotations_
BOOLEAN
MyHwResetBus (
  _In_ PVOID  DeviceExtension,
  _In_ ULONG  PahtId
  );
  {
      ...
  }

El tipo de función HW_RESET_BUS se define en el archivo de encabezado Storport.h. Para identificar con más precisión los errores al ejecutar las herramientas de análisis de código, asegúrese de agregar la anotación Use_decl_annotations a la definición de función. La anotación Use_decl_annotations garantiza que se usen las anotaciones que se aplican al tipo de función HW_RESET_BUS en el archivo de encabezado. Para obtener más información sobre los requisitos de las declaraciones de función, consulte Declaración de funciones mediante tipos de roles de función para controladores storport. Para obtener información sobre Use_decl_annotations, consulte Anotación del comportamiento de la función.

Requisitos

Requisito	Value
Plataforma de destino	Universal
Encabezado	storport.h (incluya Storport.h)
IRQL	DISPATCH_LEVEL (consulte la sección Comentarios).