Функция BdaMethodCreateTopology (bdasup.h)
Функция BdaMethodCreateTopology создает топологию шаблона между двумя контактами фильтра.
Синтаксис
NTSTATUS BdaMethodCreateTopology(
[in] PIRP pIrp,
[in] PKSMETHOD pKSMethod,
[optional] PVOID pvIgnored
);
Параметры
[in] pIrp
Указывает на IRP для запроса на создание топологии. Мини-накопитель BDA получает этот IRP с запросом KSMETHOD_BDA_CREATE_TOPOLOGY .
[in] pKSMethod
Указывает на структуру KSMETHOD , которая описывает метод и тип запроса метода.
[optional] pvIgnored
Указывает на буфер, который игнорируется.
Возвращаемое значение
Возвращает STATUS_SUCCESS или соответствующий код ошибки.
Комментарии
Мини-накопитель BDA вызывает функцию BdaMethodCreateTopology для создания топологии шаблона между двумя контактами фильтров после того, как мини-диск получит KSMETHOD_BDA_CREATE_TOPOLOGY запрос метода KSMETHODSETID_BdaDeviceConfiguration , заданный поставщиком сети. Большинство мини-драйверов BDA могут определять таблицы диспетчеризации и автоматизации фильтров, чтобы они напрямую отправляли функцию BdaMethodCreateTopology . Некоторые мини-накопители BDA должны перехватывать этот запрос с помощью внутреннего метода (KStrMethodHandler), а не отправлять его напрямую. Эти мини-накопители должны получить указатель на фильтр BDA из переданного IRP перед вызовом BdaMethodCreateTopology , чтобы они могли использовать фильтр для отслеживания связанных контактов. Затем эти мини-накопители могут отправлять инструкции на оборудование при подключении определенных типов контактов. Дополнительные сведения см. в разделах Определение таблиц автоматизации и Настройка фильтра BDA .
Если мини-накопитель BDA должен создать топологию шаблона между двумя контактами фильтров, не полагаясь на поставщика сети, мини-driver BDA должен вызвать функцию BdaCreateTopology .
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | bdasup.h (включая Bdasup.h) |
| Библиотека | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |