Função StorPortMarkDeviceFailedEx (storport.h)

A rotina StorPortMarkDeviceFailedEx marca um dispositivo com falha status e fornece dados que podem ser necessários para o diagnóstico.

Sintaxe

ULONG StorPortMarkDeviceFailedEx(
  PVOID         HwDeviceExtension,
  PSTOR_ADDRESS StorAddress,
  ULONG         Flags,
  USHORT        FaultCode,
  PWSTR         FaultDescription,
  USHORT        AdditionalDataSize,
  PUCHAR        AdditionalData,
  USHORT        CriticalDataSize,
  PUCHAR        CriticalData
);

Parâmetros

HwDeviceExtension

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

StorAddress

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

Flags

Indica o comportamento que está sendo solicitado pelo miniporto. Os sinalizadores podem ser definidos como um dos valores a seguir.

Sinalizador	Significado
STORPORT_MARK_DEVICE_FAILED_FLAG_REMOVE_DEVICE	Remova o dispositivo com falha.
STORPORT_MARK_DEVICE_FAILED_FLAG_PREDICTED_FAILURE	Indica que essa é uma falha prevista do dispositivo.

FaultCode

Código de falha específico do miniporto.

FaultDescription

Cadeia de caracteres legível por humanos que descreve a falha.

AdditionalDataSize

Tamanho em bytes do buffer para o qual AdditionalData aponta.

AdditionalData

Ponteiro para um buffer que contém dados adicionais associados à condição de falha.

CriticalDataSize

Tamanho em bytes do buffer para o qual CriticalData aponta.

CriticalData

Ponteiro para um buffer que contém dados críticos associados à condição de falha.

Retornar valor

StorPortMarkDeviceFailedEx retorna um código de STOR_STATUS válido.

Comentários

Um driver de miniporta pode chamar essa função para marcar um dispositivo com falha ou para indicar que o dispositivo falhou potencialmente.

Se nenhum sinalizador for definido em Sinalizadores, o Storport registrará apenas o evento.

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 e não estiver definido como STORPORT_MARK_DEVICE_FAILED_FLAG_PREDICTED_FAILURE, o gerenciador PnP tentará remover o dispositivo com falha.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10, versão 2004
Cabeçalho	storport.h

Confira também

IoInvalidateDeviceState

StorPortMarkDeviceFailed