Функция 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 |