ISensorClassExtension::Initialize-Methode (sensorsclassextension.h)
Die ISensorClassExtension::Initialize-Methode initialisiert das Sensorklassenerweiterungsobjekt.
Syntax
HRESULT Initialize(
IUnknown *pWdfDeviceUnknown,
IUnknown *pSensorDriverUnknown
);
Parameter
pWdfDeviceUnknown
IUnknown-Zeiger für die Treiberklasse, die die IWDFDevice-Schnittstelle implementiert.
pSensorDriverUnknown
IUnknown-Zeiger für das Objekt, das die ISensorDriver-Rückrufschnittstelle implementiert.
Rückgabewert
Diese Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem einer der folgenden Werte. Siehe Hinweise.
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Die Methode wurde erfolgreich ausgeführt. |
| E_POINTER | Das Argument war NULL, oder die IWDFDevice-Schnittstelle fehlt.. |
| HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) | Die Klassenerweiterung ist bereits initialisiert. |
| HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED) | Die Klassenerweiterung ist bereits initialisiert. |
| HRESULT_FROM_WIN32(ERROR_NOT_FOUND) | Die WPD_OBJECT_ID für den Sensor ist ungültig. |
Hinweise
Erstellen Sie zunächst die Sensorklassenerweiterung, indem Sie die COM CoCreateInstance-Methode aufrufen, und rufen Sie dann Initialize auf. Es wird empfohlen, diese Initialisierungsschritte auszuführen, wenn sie von UMDF in IPnpCallbackHardware::OnPrepareHardware aufgerufen werden. Nachdem Initialize zurückgegeben wurde, muss der Treiber bereit sein, Rückrufe von der Sensorklassenerweiterung zu empfangen. Die Sensorklassenerweiterung ruft während der Initialisierung ISensorDriver::OnGetSupportedSensorObjects auf. Ihr Treiber muss bereit sein, Werte für alle erforderlichen Eigenschaften und Datenfelder zurückzugeben, bevor Initialize aufgerufen wird.
Da die Klassenerweiterung Ihren Treiber während der Initialisierung aufruft, kann diese Methode auch HRESULTs zurückgeben, die Ihr Treiber von ISensorDriver::OnGetSupportedSensorObjects zurückgibt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | sensorsclassextension.h |
| Bibliothek | SensorsClassExtension.lib |