CODECAPI_ALLSETTINGS
Свойство CODECAPI_ALLSETTINGS используется для передачи блока данных, созданного мини-накопителем.
| Получить | Присвойте параметру | Назначение | Тип дескриптора свойства | Тип значения свойства |
|---|---|---|---|---|
| Да | Да | Фильтр | KSPROPERTY | PVOID |
Значение свойства (данные операции) имеет тип PVOID, который является указателем на буфер пользовательского режима для блока данных, созданного мини-накопителем.
Комментарии
Для вызова get свойства:
Если приложение выполняет вызов get свойства с буфером нулевой длины, мини-диск должен вернуть STATUS_BUFFER_OVERFLOW и указать требуемый размер буфера в поле Irp-IoStatus.Information>. Если буфер длины не равен нулю, мини-диск должен возвращать STATUS_BUFFER_TOO_SMALL если предоставленный буфер слишком мал для блока данных, в противном случае мини-диск упаковывает свои параметры в блок данных, который можно восстановить позже.
Мини-driver отвечает за добавление проверок целостности данных к данным, таких как уникальный ИДЕНТИФИКАТОР, указывающий, что мини-диск создал данные, циклическая избыточность проверка (CRC) и длина заголовка.
Возвращаемые данные должны быть упрощенными и содержать только сведения, необходимые для восстановления текущих параметров.
Приложения будут использовать это свойство для многоуровневых отмен, хранящихся в своих проектах и т. д.
При вызове набора свойств:
Мини-диск должен проверить целостность данных и проверка, что размер блока данных не превышает максимальный размер данных (например, отклонить все, что превышает определенный размер). Он также должен проверить CRC и длину заголовка. Мини-диск также должен кэшировать все изменения, которые будут распространены для CODECAPI_CURRENTCHANGELIST.
Требования
Заголовки: Объявлено в ksmedia.h. Включите ksmedia.h.