Compartir a través de


Función StorPortMarkDeviceFailedEx (storport.h)

La rutina StorPortMarkDeviceFailedEx marca un dispositivo con estado de error 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 la unidad de almacenamiento. Este parámetro es NULL para dispositivos adaptadores.

Flags

Indica el comportamiento solicitado por el miniport. flags se puede establecer en uno de los siguientes valores.

Bandera 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 previsto.

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 de STOR_STATUS válido.

Observaciones

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

Si no se establecen marcas en Marcas, Storport solo registrará el evento.

El administrador de PnP enviará un IRP para consultar el estado PnP del dispositivo con errores. Si marcas se establece 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 Valor
cliente mínimo admitido Windows 10, versión 2004
encabezado de storport.h

Consulte también

IoInvalidateDeviceState

StorPortMarkDeviceFailed