Skip to content

Latest commit

 

History

History
75 lines (57 loc) · 2.33 KB

nf-mcd-changererror.md

File metadata and controls

75 lines (57 loc) · 2.33 KB
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NF:mcd.ChangerError
ChangerError function (mcd.h)
ChangerError performs device-specific error handling.
storage\changererror.htm
storage
03/29/2018
ChangerError function
ChangerError, ChangerError function [Storage Devices], chgrmini_5235b77f-51d1-4fa5-b68c-3e649aed829c.xml, mcd/ChangerError, storage.changererror
mcd.h
Mcd.h, Ntddchgr.h
Desktop
PASSIVE_LEVEL
Windows
ChangerError
mcd/ChangerError
APIRef
kbSyntax
HeaderDef
mcd.h
ChangerError

ChangerError function

-description

ChangerError performs device-specific error handling.

-parameters

-param DeviceObject

Pointer to the device object that represents the changer.

-param Srb

Pointer to the SCSI request block for the operation that failed.

-param Status

Specifies the address of the STATUS_XXX code set by the system. The changer miniclass driver can change the status or leave it as is.

-param Retry

Pointer to a flag that indicates whether to retry the request. The changer miniclass driver can set this flag or leave it as is.

-remarks

This routine is required.

If an SRB fails with a SCSI status of CHECK CONDITION, the SCSI class driver calls the changer class driver's ChangerClassError routine. ChangerClassError performs device-independent error handling and calls the changer miniclass driver's ChangerError routine.

ChangerError first checks Srb->SrbStatus with SRB_STATUS_AUTOSENSE_VALID to make sure the sense data buffer is valid. If so, it checks the sense data in Srb->SenseInfoBuffer to determine whether to update *Status with a more accurate STATUS_XXX code and/or set the Retry flag before returning to the changer class driver. The changer class driver's retry count determines whether the SRB is actually retried.