Функция обратного вызова PFNKSDEVICECREATE (ks.h)
Подпрограмма AVStrMiniDeviceAdd мини-драйвера AVStream уведомляет мини-driver о том, что подпрограмма PnP AddDevice avStream завершена.
Синтаксис
PFNKSDEVICECREATE Pfnksdevicecreate;
NTSTATUS Pfnksdevicecreate(
[in] PKSDEVICE Device
)
{...}
Параметры
[in] Device
Указатель на структуру KSDEVICE, описывающую только что созданный объект функционального устройства (FDO).
Возвращаемое значение
Должен возвращать STATUS_SUCCESS или код ошибки, возвращенный при попытке выполнить операцию. Если мини-диск возвращает состояние сбоя, соответствующий вызов AddDevice также завершится ошибкой. Дополнительные сведения см. в разделе Примечания ниже.
Комментарии
Мини-driver указывает адрес этой подпрограммы в разделе Добавление элемента структуры KSDEVICE_DISPATCH .
AVStream вызывает AVStrMiniDeviceAdd из стандартной процедуры AddDevice во время инициализации KSDEVICE . В момент вызова этой подпрограммы создается объект устройства WDM (DEVICE_OBJECT), создается и инициализирована структура KSDEVICE и выделен заголовок устройства KS.
Мини-накопители могут использовать эту подпрограмму для связывания контекстных сведений с объектом устройства AVStream или для инициализации расширения устройства.
Если эта подпрограмма возвращает код состояния с ошибкой, подпрограмма AddDevice avStream завершится ошибкой. STATUS_PENDING не является юридическим кодом возврата, так как не используется IRP. Подпрограмма вызывается в IRQL = только PASSIVE_LEVEL.
Эта подпрограмма является необязательной.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в операционных системах Microsoft Windows XP и более поздних версиях, а также DirectX 8.0 и более поздних версиях. |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | ks.h (включая Ks.h) |
| IRQL | PASSIVE_LEVEL (см. раздел "Примечания") |