ISensorDriver：：OnClientSubscribeToEvents 方法（sensorsclassextension.h）

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

語法

HRESULT OnClientSubscribeToEvents(
  IWDFFile *pClientFile,
  LPWSTR   pwszSensorID
);

pClientFile

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

pwszSensorID

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

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

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

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

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

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