IOCTL_STORAGE_GET_MEDIA_SERIAL_NUMBER IOCTL (ntddstor.h)

Запрашивает у универсального родительского драйвера USB серийный номер USB-устройства. Если USB-устройство имеет интерфейс безопасности содержимого CSM-1, драйвер КЛИЕНТА USB может запросить его серийный номер с помощью этого запроса. Драйверы USB-клиента, которые помогают реализовать систему управления цифровыми правами (DRM), могут использовать эти сведения, чтобы гарантировать, что только законные клиенты имеют доступ к цифровой интеллектуальной собственности.

Основной код

IRP_MJ_DEVICE_CONTROL

Входной буфер

Нет.

Длина входного буфера

Нет.

Выходной буфер

Драйвер возвращает серийный номер указанного устройства в структуре типа MEDIA_SERIAL_NUMBER_DATA в буфере по адресу Irp-AssociatedIrp.SystemBuffer>.

Длина выходного буфера

Parameters.DeviceIoControl.OutputBufferLength в расположении стека ввода-вывода IRP указывает размер буфера в байтах, который должен быть не менее sizeof(MEDIA_SERIAL_NUMBER_DATA).

Блок состояния

В поле Сведения задается размер возвращаемых данных в байтах. Для поля Состояние можно задать значение STATUS_SUCCESS или, возможно, STATUS_INVALID_BUFFER_SIZE или STATUS_INSUFFICIENT_RESOURCES.

Требования

Требование	Значение
Заголовок	ntddstor.h (включая Ntddstor.h)

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

MEDIA_SERIAL_NUMBER_DATA