ISensorDriver::OnGetSupportedEvents 方法 (sensorsclassextension.h)
ISensorDriver::OnGetSupportedEvents 方法會擷取指定感測器可以引發的事件清單。
語法
HRESULT OnGetSupportedEvents(
LPWSTR pwszSensorID,
GUID **ppSupportedEvents,
ULONG *pulEventCount
);
參數
pwszSensorID
LPWSTR,其中包含用戶端應用程式要求事件清單之感測器的標識碼。
ppSupportedEvents
接收支援事件識別碼陣列之 GUID 指標的位址。 如果驅動程式不支援事件,則傳回緩衝區,其中包含其值設定為 GUID_NULL的單一 GUID。
pulEventCount
接收透過ppSupportedEvents傳回之緩衝區中事件標識碼計數的ULONG位址。 如果驅動程式不支援事件,請將此值設定為零。
傳回值
如果作業成功,這個方法會傳回S_OK。 否則,這個方法會傳回 Winerror.h 中定義的其中一個錯誤碼。
備註
事件標識碼是以 GUID 表示。 平台定義的事件定義於 sensors.h 中。
您必須使用 CoTaskMemAlloc 來建立事件識別碼緩衝區。 感測器類別延伸模組會釋放此記憶體。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | sensorsclassextension.h |
程式庫 | SensorsClassExtension.lib |