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 valore 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 manca l'interfaccia IWDFDevice . |
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. |
Commenti
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'operazione Initialize, 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ò anche restituire HRESULTs restituiti dal driver da ISensorDriver::OnGetSupportedSensorObjects.
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Windows |
Intestazione | sensorsclassextension.h |
Libreria | SensorsClassExtension.lib |