Partilhar via


Função StorPortMarkDeviceFailed (storport.h)

A rotina StorPortMarkDeviceFailed marca um dispositivo com status de falha. Consulte também StorPortMarkDeviceFailedEx .

Sintaxe

void StorPortMarkDeviceFailed(
  PVOID         HwDeviceExtension,
  PSTOR_ADDRESS StorAddress,
  ULONG         Flags,
  PWSTR         FailReason
);

Parâmetros

HwDeviceExtension

Ponteiro para a extensão do dispositivo de hardware para o HBA (adaptador do barramento de host).

StorAddress

Endereço do dispositivo da unidade de armazenamento. Esse parâmetro é NULL para dispositivos adaptador.

Flags

Defina como STORPORT_MARK_DEVICE_FAILED_FLAG_REMOVE_DEVICE para remover o dispositivo com falha.

FailReason

Cadeia de caracteres que especifica o motivo da falha do dispositivo junto com outros detalhes.

Valor de retorno

Nenhum

Observações

Um driver de miniporto pode chamar essa função para marcar um dispositivo com falha. Se STORPORT_MARK_DEVICE_FAILED_FLAG_REMOVE_DEVICE não estiver definido no Flags, o Storport registrará o evento apenas em log.

O gerenciador PnP enviará um IRP para consultar o estado PnP do dispositivo com falha. Se Flags estiver definido como STORPORT_MARK_DEVICE_FAILED_FLAG_REMOVE_DEVICE, o gerenciador PnP tentará remover o dispositivo com falha.

Requisitos

Requisito Valor
cabeçalho storport.h

Consulte também

IoInvalidateDeviceState

StorPortMarkDeviceFailedEx