PFNBTHPORT_INDICATION_CALLBACK回呼函式 (bthddi.h)
配置文件驅動程式會實作 L2CAP 回呼函式,以提供藍牙驅動程式堆疊的機制,以通知配置檔驅動程式來自遠端裝置的傳入 L2CAP 連線要求,以及目前開啟 L2CAP 連線狀態的任何變更。
語法
PFNBTHPORT_INDICATION_CALLBACK PfnbthportIndicationCallback;
void PfnbthportIndicationCallback(
[in] PVOID Context,
[in] INDICATION_CODE Indication,
[in] PINDICATION_PARAMETERS Parameters
)
{...}
參數
[in] Context
針對連入遠端連線要求指示,這是 IndicationCallbackContext 中配置檔驅動程式所指定的內容, 成員當配置檔驅動程式註冊回呼函式時, _BRB_L2CA_REGISTER_SERVER 結構。 對於現有 L2CAP 連線的變更,這是建置並傳送 _BRB_L2CA_OPEN_CHANNEL BRB 時,配置檔驅動程式所指定的 CallbackContext 成員。
[in] Indication
指出 L2CAP 事件類型的 INDICATION_CODE 值。
[in] Parameters
包含事件特定參數的 INDICATION_PARAMETERS 結構。
傳回值
沒有
言論
設定檔驅動程式會在下列兩個案例中註冊其 L2CAP 回呼函式:
- 當配置檔驅動程式作為伺服器時,它會使用 IndicationCallback 成員註冊 L2CAP 回呼函式 _BRB_L2CA_REGISTER_SERVER 結構。 接著,當遠端裝置嘗試連絡時,藍牙驅動程式堆疊可以通知配置檔驅動程式。
- 當配置檔驅動程式作為用戶端,並嘗試使用 BRB_L2CA_OPEN_CHANNEL BRB 連線到遠端裝置時,配置檔驅動程式會使用 Callback _BRB_L2CA_OPEN_CHANNEL 成員註冊其 L2CAP 回呼函式,該函式會使用配置檔驅動程式 建置並傳送BRB_L2CA_OPEN_CHANNEL 或 BRB_L2CA_OPEN_CHANNEL_RESPONSE 要求。
Parameters 參數中保留的 INDICATION_PARAMETERS 結構會根據藍牙驅動程式堆棧透過 指示 參數傳遞至配置檔驅動程式 L2CAP 回呼函式的 INDICATION_CODE 列舉值來解譯。 對於大部分的通知,有一個INDICATION_PARAMETERS等位成員對應至事件,並包含事件特定的參數。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows Vista 和更新版本中的版本:_Supported。 |
目標平臺 | 桌面 |
標頭 | bthddi.h (包括 Bthddi.h) |
IRQL | 開發人員應該撰寫此函式以在 IRQL = DISPATCH_LEVEL運作(如果回呼函式無法存取分頁記憶體),或 IRQL = PASSIVE_LEVEL (如果回呼函式必須存取分頁記憶體) |