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 |