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

Статья
08/07/2023

Функция BdaMethodCreatePin создает фабрику контактов.

Синтаксис

NTSTATUS BdaMethodCreatePin(
  [in]            PIRP      pIrp,
  [in]            PKSMETHOD pKSMethod,
  [out, optional] PULONG    pulPinFactoryID
);

Параметры

[in] pIrp

Указывает на IRP для запроса на создание фабрики контактов. Мини-диск BDA получает этот IRP с запросом KSMETHOD_BDA_CREATE_PIN_FACTORY .

[in] pKSMethod

Указывает на структуру KSMETHOD , описывающую метод и тип запроса метода.

[out, optional] pulPinFactoryID

Указывает на переменную, которая получает идентификатор фабрики контактов.

Возвращаемое значение

Возвращает STATUS_SUCCESS или соответствующий код ошибки.

Мини-накопитель BDA вызывает функцию BdaMethodCreatePin для создания фабрики контактов после того, как мини-диск получит KSMETHOD_BDA_CREATE_PIN_FACTORY запрос метода KSMETHODSETID_BdaDeviceConfiguration от поставщика сети. Большинство мини-драйверов BDA могут определять таблицы диспетчеризации и автоматизации фильтрации, чтобы эти мини-драйверы отправляли функцию BdaMethodCreatePin напрямую, не перехватывая этот запрос с помощью внутреннего метода (KStrMethodHandler). Дополнительные сведения см. в разделах Определение таблиц автоматизации и Настройка фильтра BDA .

Если мини-накопитель BDA должен создать пин-код, не полагаясь на поставщика сети, мини-накопитель BDA должен вызвать функцию BdaCreatePin .

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	bdasup.h (включая Bdasup.h)
Библиотека	Bdasup.lib
IRQL	PASSIVE_LEVEL