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