IOCTL_STORAGE_GET_MEDIA_SERIAL_NUMBER IOCTL (ntddstor.h)
Запрашивает у универсального родительского драйвера USB серийный номер USB-устройства. Если USB-устройство имеет интерфейс безопасности содержимого CSM-1, драйвер КЛИЕНТА USB может запросить его серийный номер с помощью этого запроса. Драйверы USB-клиента, которые помогают реализовать систему управления цифровыми правами (DRM), могут использовать эти сведения, чтобы гарантировать, что только законные клиенты имеют доступ к цифровой интеллектуальной собственности.
Основной код
Входной буфер
Нет.
Длина входного буфера
Нет.
Выходной буфер
Драйвер возвращает серийный номер указанного устройства в структуре типа 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) |