ChangerGetStatus function (mcd.h)

Article
02/22/2024

ChangerGetStatus handles the device-specific aspects of a device-control IRP with the IOCTL code IOCTL_CHANGER_GET_STATUS.

Syntax

NTSTATUS ChangerGetStatus(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PIRP           Irp
);

Parameters

[in] DeviceObject

Pointer to the device object that represents the changer.

[in] Irp

Pointer to the IRP.

Return value

ChangerGetStatus returns the STATUS_XXX value returned by the system port driver. If there is not enough memory to process the request or to process the STATUS_XXX value returned by the system port driver ChangerGetStatus returns STATUS_INSUFFICIENT_RESOURCES.

Remarks

This routine is required.

ChangerGetStatus indicates whether the changer is able to accept requests.

ChangerGetStatus builds an SRB with a CDB to get the changer's status (using the SCSI command TEST UNIT READY or non-SCSI equivalent) and sends it to the system port driver to obtain status of the changer.

Requirements

Requirement	Value
Target Platform	Desktop
Header	mcd.h (include Mcd.h, Ntddchgr.h)
IRQL	PASSIVE_LEVEL