Функция ChangerInitializeElementStatus (mcd.h)
ChangerInitializeElementStatus обрабатывает аспекты IRP для управления устройствами с помощью кода IOCTL IOCTL_CHANGER_INITIALIZE_ELEMENT_STATUS.
Синтаксис
NTSTATUS ChangerInitializeElementStatus(
[in] PDEVICE_OBJECT DeviceObject,
[in] PIRP Irp
);
Параметры
[in] DeviceObject
Указатель на объект устройства, представляющий средство изменения.
[in] Irp
Указатель на IRP.
Возвращаемое значение
ChangerInitializeElementStatus возвращает состояние, возвращаемое драйвером системного порта или одним из следующих значений:
STATUS_SUCCESS
STATUS_INVALID_PARAMETER
STATUS_INSUFFICIENT_RESOURCES
Если изменение не поддерживает инициализацию диапазона элементов определенного типа и вызывается ChangerInitializeElementStatus с типом элемента, отличным от AllElements, он возвращает STATUS_INVALID_PARAMETER.
Замечания
Эта подпрограмма требуется.
ChangerInitializeElementStatus обновляет внутреннюю память меняющегося с текущими сведениями о его элементах.
Драйвер класса changer проверяет длину входного буфера в расположении стека ввода-вывода перед вызовом ChangerInitializeElementStatus.
Irp—>SystemBuffer указывает на структуру CHANGER_INITIALIZE_ELEMENT_STATUS в качестве входного параметра, указывающего элементы, для которых необходимо инициализировать состояние элемента с данными, полученными из меток штрих-кода.
Для SCSI changer ChangerInitializeElementStatus создает SRB с CDB для инициализации состояния элемента, преобразует адреса элементов на адреса, относящиеся к устройству, и отправляет SRB в драйвер системного порта.
ChangerInitializeElementStatus задает поле Information в блоке состояния ввода-вывода значение sizeof(CHANGER_INITIALIZE_ELEMENT_STATUS), прежде чем вернуться к драйверу класса changer.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | mcd.h (включая Mcd.h, Ntddchgr.h) |
| IRQL | PASSIVE_LEVEL |