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 unterstützter Ereignis-IDs empfängt. Wenn der Treiber keine Ereignisse unterstützt, geben Sie einen Puffer zurück, der eine einzelne GUID enthält, deren Wert auf GUID_NULL festgelegt ist.
pulEventCount
Adresse eines ULONG, das 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.
Bemerkungen
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 Speicher frei.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Fenster |
| Header- | sensorsclassextension.h |
| Library | SensorsClassExtension.lib |