função de retorno de chamada HW_RESET_BUS (storport.h)

A rotina HwStorResetBus é chamada pelo driver de porta para limpar as condições de erro.

Sintaxe

HW_RESET_BUS HwResetBus;

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

Parâmetros

DeviceExtension

Um ponteiro para o driver de miniporto por área de armazenamento do HBA.

PathId

Identifica o barramento SCSI a ser redefinido.

Retornar valor

Se o barramento for redefinido com êxito, HwStorResetBus retornará TRUE.

Comentários

O nome HwStorResetBus é apenas um espaço reservado. O protótipo real dessa rotina é definido em Storport.h da seguinte maneira:

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

O driver de porta pausa todas as filas de E/S do dispositivo para o adaptador e chama a rotina HwStorResetBus no IRQL DISPATCH_LEVEL depois de adquirir o bloqueio de rotação StartIo. Um driver de miniporte é responsável por concluir SRBs recebidos por HwStorStartIo para PathId durante essa rotina e definir seus status para SRB_STATUS_BUS_RESET, se necessário.

Além do bloqueio de rotação StartIo que está sendo feito e posteriormente liberado após o retorno de HwStorResetBus , se o miniporto tiver solicitado suporte a vários canais por meio de PERF_CONFIGURATION_DATA, todos os tokens de canal serão obtidos e, no retorno do retorno de chamada, liberados. Isso garante que nenhuma E/S seja enviada para o HwStorStartIo durante a fase do barramento de redefinição.

Exemplos

Para definir uma função de retorno de chamada HwStorResetBus , primeiro você deve fornecer uma declaração de função que identifique o tipo de função de retorno de chamada que você está definindo. O Windows fornece um conjunto de tipos de função de retorno de chamada para drivers. Declarar uma função usando os tipos de função de retorno de chamada ajuda a Análise de Código para Drivers, SDV ( Verificador de Driver Estático ) e outras ferramentas de verificação a encontrar erros e é um requisito para gravar drivers para o sistema operacional Windows.

Por exemplo, para definir uma rotina de retorno de chamada HwStorResetBus chamada MyHwResetBus, use o tipo HW_RESET_BUS conforme mostrado neste exemplo de código:

HW_RESET_BUS MyHwResetBus;

Em seguida, implemente sua rotina de retorno de chamada da seguinte maneira:

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

O tipo de função HW_RESET_BUS é definido no arquivo de cabeçalho Storport.h. Para identificar erros com mais precisão ao executar as ferramentas de análise de código, adicione a anotação Use_decl_annotations à sua definição de função. A anotação Use_decl_annotations garante que as anotações aplicadas ao tipo de função HW_RESET_BUS no arquivo de cabeçalho sejam usadas. Para obter mais informações sobre os requisitos para declarações de função, consulte Declarando funções usando tipos de função para drivers storport. Para obter informações sobre Use_decl_annotations, consulte Anotando o comportamento da função.

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Cabeçalho	storport.h (inclua Storport.h)
IRQL	DISPATCH_LEVEL (consulte a seção Comentários.)