ISensorDriver：：OnClientConnect 方法 (sensorsclassextension.h)
ISensorDriver：：OnClientConnect 方法會通知感測器驅動程式用戶端應用程式已連線。
語法
HRESULT OnClientConnect(
IWDFFile *pClientFile,
LPWSTR pwszSensorID
);
參數
pClientFile
IWDFFile 介面的指標，代表要求連接之應用程式的檔案物件。
pwszSensorID
LPWSTR，其中包含用戶端應用程式所連接之感測器的標識碼。
傳回值
如果作業成功，這個方法會傳回S_OK。 否則，此方法會傳回 Winerror.h 中定義的其中一個錯誤碼。
備註
只有在指定的用戶端應用程式已獲得使用者存取驅動程式的許可權時，感測器類別延伸模組才會呼叫此方法。 如果使用者撤銷此許可權，類別延伸模組會立即呼叫相同應用程式/感測器配對的 ISensorDriver：：OnClientDisconnect 。
類別延伸模組一律會在呼叫特定感測器的 ISensorDriver：：OnSetProperties 或 ISensorDriver：：OnGetDataFields 之前呼叫這個方法。 建議您維護已連線應用程式的參考計數，以協助預期何時可以呼叫這三種方法。 如果沒有連線用戶端應用程式，您可以採取步驟來降低耗電量，以變更驅動程序的行為。
您可以使用指標值 (pClientFile 所提供) 的位址做為一種識別符，以追蹤連線的應用程式。 不過，您必須針對每個感測器個別追蹤這些標識符，而不是針對每個裝置，因為類別延伸模組可能會為相同裝置上的多個感測器提供相同的指標值。
如需如何使用此方法的詳細資訊，請參閱 篩選數據。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | sensorsclassextension.h |
| 程式庫 | SensorsClassExtension.lib |