ISensorDriver：：OnClientSubscribeToEvents 方法 (sensorsclassextension.h)

ISensorDriver：：OnClientSubscribeToEvents 方法會通知感測器驅動程式授權用戶端應用程式要求事件通知。

語法

HRESULT OnClientSubscribeToEvents(
  IWDFFile *pClientFile,
  LPWSTR   pwszSensorID
);

pClientFile

IWDFFile 介面的指標，代表要求事件通知之應用程式的檔案物件。

pwszSensorID

LPWSTR，其中包含用戶端應用程式要求事件通知之感測器的標識碼。

如果作業成功，這個方法會傳回S_OK。否則，此方法會傳回 Winerror.h 中定義的其中一個錯誤碼。

當用戶端應用程式要求事件通知時，驅動程式會將所有事件引發至指定物件標識碼的感測器類別延伸模組。然後，類別延伸模組會將這些事件轉送到感測器 API 作為應用程式的事件通知。

您可以為每個感測器維護連線應用程式的參考計數，以避免在不需要時發出事件回呼。

平台定義的事件定義於 sensors.h 中。

如需如何使用此方法的詳細資訊，請參閱篩選數據。