Функция BdaPropertyGetControllingPinId (bdasup.h)

Статья
08/07/2023

Функция 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

См. также раздел

KSPROPERTY_BDA_CONTROLLING_PIN_ID

KSPROPSETID_BdaTopology

KSP_BDA_NODE_PIN

Share via