Metodo ISensorClassExtension::Initialize (sensorsclassextension.h)
Il metodo ISensorClassExtension::Initialize inizializza l'oggetto estensione della classe del sensore.
Sintassi
HRESULT Initialize(
IUnknown *pWdfDeviceUnknown,
IUnknown *pSensorDriverUnknown
);
Parametri
pWdfDeviceUnknown
Puntatore IUnknown per la classe driver che implementa l'interfaccia IWDFDevice.
pSensorDriverUnknown
Puntatore IUnknown per l'oggetto che implementa l'interfaccia di callback ISensorDriver.
Valore restituito
Questo metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, uno dei valori seguenti. Vedere la sezione Osservazioni.
| codice restituito | Descrizione |
|---|---|
| S_OK | Il metodo è riuscito. |
| E_POINTER | L'argomento è NULL o l'interfaccia IWDFDevice mancante. |
| HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) | L'estensione della classe è già inizializzata. |
| HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED) | L'estensione della classe è già inizializzata. |
| HRESULT_FROM_WIN32(ERROR_NOT_FOUND) | Il WPD_OBJECT_ID per il sensore non è valido. |
Osservazioni
Creare prima di tutto l'estensione della classe del sensore chiamando il metodo COM CoCreateInstance e quindi chiamare Initialize. È consigliabile eseguire questi passaggi di inizializzazione quando viene chiamato da UMDF in IPnpCallbackHardware::OnPrepareHardware. Al termine dell'inizializzazione, il driver deve essere pronto per ricevere i callback dall'estensione della classe del sensore. L'estensione della classe del sensore chiama ISensorDriver::OnGetSupportedSensorObjects durante l'inizializzazione. Il driver deve essere pronto per restituire i valori per tutte le proprietà e i campi dati necessari prima di chiamare Initialize.
Poiché l'estensione della classe chiama il driver durante l'inizializzazione, questo metodo può restituire anche HRESULTs restituiti dal driver da ISensorDriver::OnGetSupportedSensorObjects.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Finestre |
| intestazione | sensorsclassextension.h |
| libreria | SensorsClassExtension.lib |