Функция BdaPropertyGetControllingPinId (bdasup.h)
Функция BdaPropertyGetControllingPinId извлекает идентификатор контакта, на котором можно управлять свойствами, методами и событиями определенного узла.
Синтаксис
NTSTATUS BdaPropertyGetControllingPinId(
[in] PIRP Irp,
[in] PKSP_BDA_NODE_PIN Property,
[out, optional] PULONG pulControllingPinId
);
Параметры
[in] Irp
Указывает на IRP для запроса на получение контрольного контакта для узла. Мини-диск BDA получает этот IRP с запросом KSPROPERTY_BDA_CONTROLLING_PIN_ID .
[in] Property
Указывает на структуру KSP_BDA_NODE_PIN , описывающую свойство и тип запроса свойства для получения контрольного маркера для узла.
[out, optional] pulControllingPinId
Указывает на переменную, которая получает идентификатор управляющего контакта для узла.
Возвращаемое значение
Возвращает STATUS_SUCCESS или соответствующий код ошибки.
Комментарии
Мини-driver BDA вызывает функцию BdaPropertyGetControllingPinId , чтобы получить идентификатор управляющего контакта для узла после того, как мини-накопитель получит KSPROPERTY_BDA_CONTROLLING_PIN_ID запрос свойства KSPROPSETID_BdaTopology , заданного от поставщика сети. Большинство мини-драйверов BDA могут определять таблицы диспетчеризации и автоматизации фильтрации, чтобы эти мини-драйверы отправляли функцию BdaPropertyGetControllingPinId напрямую, не перехватывая этот запрос с помощью внутреннего обработчика get (KStrGetPropertyHandler). Дополнительные сведения см. в разделах Определение таблиц автоматизации и Определение топологии устройств BDA .
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | bdasup.h (включая Bdasup.h) |
| Библиотека | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |