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
對於連入遠端連線要求指示,這是指示 CallbackContext 成員中配置檔驅動程式所指定的內容 _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 連線到遠端裝置時,配置檔驅動程式會使用設定檔驅動程式建置並傳送BRB_L2CA_OPEN_CHANNEL時所傳遞之_BRB_L2CA_OPEN_CHANNEL結構的 Callback 成員註冊其 L2CAP 回呼函式或 BRB_L2CA_OPEN_CHANNEL_RESPONSE 要求。
參數中保留的INDICATION_PARAMETERS結構會根據藍牙驅動程式堆棧透過指示參數傳遞至配置文件驅動程式的 L2CAP 回呼函式INDICATION_CODE列舉值來解譯。 對於大部分的通知,有一個對應至事件的INDICATION_PARAMETERS等位成員,並包含事件特定的參數。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista 和更新版本中的版本:_Supported。 |
目標平台 | 桌面 |
標頭 | bthddi.h (包含 Bthddi.h) |
IRQL | 如果回呼函式無法存取分頁記憶體) ,則開發人員應該撰寫此函式的程式代碼,以在 IRQL = DISPATCH_LEVEL (运作,PASSIVE_LEVEL (如果回呼函式必須存取分頁記憶體) |