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 函式，以在minidriver收到從網路提供者設定的 KSMETHODSETID_BdaDeviceConfiguration 方法KSMETHOD_BDA_CREATE_PIN_FACTORY要求之後建立釘選處理站。大部分的 BDA 迷你驅動程式都可以定義分派和篩選自動化數據表，讓這些迷你驅動程式直接分派 BdaMethodCreatePin 函式，而不需使用內部方法攔截此要求， (KStrMethodHandler) 。如需詳細資訊，請參閱定義自動化數據表和設定 BDA 篩選。

如果 BDA 迷你驅動程式必須建立針腳而不依賴網路提供者，BDA 迷你驅動程式應該呼叫 BdaCreatePin 函式。