ISensorDriver::OnGetSupportedEvents-Methode (sensorsclassextension.h)

Die ISensorDriver::OnGetSupportedEvents-Methode ruft die Liste der Ereignisse ab, die der angegebene Sensor auslösen kann.

Syntax

HRESULT OnGetSupportedEvents(
  LPWSTR pwszSensorID,
  GUID   **ppSupportedEvents,
  ULONG  *pulEventCount
);

Parameter

pwszSensorID

LPWSTR, das die ID für den Sensor enthält, von dem die Clientanwendung die Ereignisliste anfordert.

ppSupportedEvents

Adresse eines GUID-Zeigers, der das Array der unterstützten Ereignis-IDs empfängt. Wenn der Treiber keine Ereignisse unterstützt, gibt einen Puffer zurück, der eine einzelne GUID enthält, deren Wert auf GUID_NULL festgelegt ist.

pulEventCount

Adresse einer ULONG, die die Anzahl der Ereignis-IDs im Puffer empfängt, die über ppSupportedEvents zurückgegeben werden. Wenn der Treiber keine Ereignisse unterstützt, legen Sie diesen Wert auf Null fest.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt diese Methode S_OK zurück. Andernfalls gibt diese Methode einen der Fehlercodes zurück, die in Winerror.h definiert sind.

Hinweise

Ereignis-IDs werden durch GUIDs dargestellt. Plattformdefinierte Ereignisse werden in sensors.h definiert.

Sie müssen CoTaskMemAlloc verwenden, um den Ereignis-ID-Puffer zu erstellen. Die Sensorklassenerweiterung gibt diesen Arbeitsspeicher frei.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	sensorsclassextension.h
Bibliothek	SensorsClassExtension.lib

Weitere Informationen

ISensorDriver