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