Función StorPortMarkDeviceFailedEx (storport.h)

La rutina StorPortMarkDeviceFailedEx marca un dispositivo con estado erróneo y proporciona datos que podrían ser necesarios para el diagnóstico.

Sintaxis

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

Parámetros

HwDeviceExtension

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

StorAddress

Dirección del dispositivo de unidad de almacenamiento. Este parámetro es NULL para dispositivos adaptadores.

Flags

Indica el comportamiento solicitado por el miniporte. Las marcas se pueden establecer en uno de los valores siguientes.

Marca	Significado
STORPORT_MARK_DEVICE_FAILED_FLAG_REMOVE_DEVICE	Quite el dispositivo con errores.
STORPORT_MARK_DEVICE_FAILED_FLAG_PREDICTED_FAILURE	Indica que se trata de un error de dispositivo predicho.

FaultCode

Código de error específico de miniporte.

FaultDescription

Cadena legible que describe el error.

AdditionalDataSize

Tamaño en bytes del búfer al que Apunta AdditionalData .

AdditionalData

Puntero a un búfer que contiene datos adicionales asociados a la condición de error.

CriticalDataSize

Tamaño en bytes del búfer al que Apunta CriticalData .

CriticalData

Puntero a un búfer que contiene datos críticos asociados a la condición de error.

Valor devuelto

StorPortMarkDeviceFailedEx devuelve un código STOR_STATUS válido.

Comentarios

Un controlador de minipuerto puede llamar a esta función para marcar un dispositivo con errores o para indicar que el dispositivo ha producido un error potencial.

Si no hay marcas establecidas en Marcas, Storport solo registrará el evento.

El administrador de PnP enviará un IRP para consultar el estado PnP del dispositivo con errores. Si Flags está establecido en STORPORT_MARK_DEVICE_FAILED_FLAG_REMOVE_DEVICE y no se establece en STORPORT_MARK_DEVICE_FAILED_FLAG_PREDICTED_FAILURE, el administrador de PnP intentará quitar el dispositivo con errores.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10, versión 2004
Encabezado	storport.h

Consulte también

IoInvalidateDeviceState

StorPortMarkDeviceFailed