次の方法で共有


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