BdaMethodCreatePin 関数 (bdasup.h)

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

構文

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

パラメーター

[in] pIrp

PIN ファクトリを作成する要求の 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 関数を呼び出す必要があります。

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー bdasup.h (Bdasup.h を含む)
ライブラリ Bdasup.lib
IRQL PASSIVE_LEVEL

関連項目

BdaCreatePin

BdaMethodDeletePin

KSMETHOD

KSMETHODSETID_BdaDeviceConfiguration

KSMETHOD_BDA_CREATE_PIN_FACTORY

KStrMethodHandler