Поделиться через


Функция ChangerGetProductData (mcd.h)

ChangerGetProductData обрабатывает аспекты IRP для управления устройством с помощью IOCTL_CHANGER_GET_PRODUCT_DATA кода IOCTL.

Синтаксис

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

Параметры

[in] DeviceObject

Указатель на объект устройства, представляющий средство изменения.

[in] Irp

Указатель на IRP.

Возвращаемое значение

ChangerGetProductData всегда возвращает STATUS_SUCCESS.

Комментарии

Эта подпрограмма является обязательной.

ChangerGetProductData возвращает данные о продукте для средства изменения.

Драйвер класса средств изменения проверяет длину выходного буфера в расположении стека ввода-вывода перед вызовом ChangerGetProductData. Если длина выходного буфера меньше , чем sizeof(CHANGER_PRODUCT_DATA), то драйвер класса средства изменения возвращает значение STATUS_INFO_LENGTH_MISMATCH

ChangerGetProductData заполняет структуру CHANGER_PRODUCT_DATA в Irp-AssociatedIrp.SystemBuffer>, прежде чем вернуться к драйверу класса средства изменения. Если драйвер мини-класса кэширует данные запроса в расширении устройства модуля изменения перед возвратом из ChangerInitialize, все члены, кроме DeviceType , могут быть заполнены из этих данных.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть mcd.h (включая Mcd.h, Ntddchgr.h)
IRQL PASSIVE_LEVEL

См. также раздел

CHANGER_PRODUCT_DATA

ChangerInitialize