BdaMethodCreatePin 関数 (bdasup.h)

[アーティクル]
02/22/2024

BdaMethodCreatePin 関数は、ピンファクトリを作成します。

構文

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

パラメーター

[in] pIrp

ピンファクトリを作成する要求の IRP を指します。 BDA ミニドライバーは、 KSMETHOD_BDA_CREATE_PIN_FACTORY 要求でこの IRP を受け取ります。

[in] pKSMethod

メソッド要求のメソッドと要求の種類を記述する KSMETHOD 構造体を指します。

[out, optional] pulPinFactoryID

ピンファクトリの識別子を受け取る変数を指します。

戻り値

STATUS_SUCCESSまたは適切なエラーコードを返します。

注釈

BDA ミニドライバーは 、BdaMethodCreatePin 関数を呼び出して、ミニドライバーがネットワークプロバイダーから設定されたKSMETHODSETID_BdaDeviceConfiguration メソッドの KSMETHOD_BDA_CREATE_PIN_FACTORY 要求を受け取った後にピンファクトリを作成します。ほとんどの BDA ミニドライバーは、ディスパッチテーブルとフィルターオートメーションテーブルを定義して、これらのミニドライバーが内部メソッド (KStrMethodHandler) を使用してこの要求をインターセプトすることなく、BdaMethodCreatePin 関数を直接ディスパッチできるようにします。詳細については、自動化テーブルの定義と BDA フィルターの構成に関するページを参照してください。

BDA ミニドライバーがネットワークプロバイダーに依存せずにピンを作成する必要がある場合、BDA ミニドライバーは BdaCreatePin 関数を呼び出す必要があります。