ISensorClassExtension ::Initialize, méthode (sensorsclassextension.h)
La méthode ISensorClassExtension ::Initialize initialise l’objet d’extension de classe de capteur.
Syntaxe
HRESULT Initialize(
IUnknown *pWdfDeviceUnknown,
IUnknown *pSensorDriverUnknown
);
Paramètres
pWdfDeviceUnknown
Pointeur IUnknown pour la classe de pilote qui implémente l’interface IWDFDevice.
pSensorDriverUnknown
Pointeur IUnknown pour l’objet qui implémente l’interface de rappel ISensorDriver.
Valeur de retour
Cette méthode retourne un HRESULT. Les valeurs possibles incluent, mais ne sont pas limitées à, l’une des valeurs suivantes. Voir les remarques.
| code de retour | Description |
|---|---|
| S_OK | La méthode a réussi. |
| E_POINTER | L’argument a été NULL ou l’interface IWDFDevice est manquante.. |
| HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) | L’extension de classe est déjà initialisée. |
| HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED) | L’extension de classe est déjà initialisée. |
| HRESULT_FROM_WIN32(ERROR_NOT_FOUND) | La WPD_OBJECT_ID du capteur n’est pas valide. |
Remarques
Tout d’abord, créez l’extension de classe de capteur en appelant la méthode COM CoCreateInstance, puis appelez Initialize. Nous vous recommandons d’effectuer ces étapes d’initialisation lorsqu’elle est appelée par UMDF dans IPnpCallbackHardware ::OnPrepareHardware. Une fois initialisé, le pilote doit être prêt à recevoir des rappels à partir de l’extension de classe de capteur. L’extension de classe de capteur appelle ISensorDriver ::OnGetSupportedSensorObjects pendant l’initialisation. Votre pilote doit être prêt à retourner des valeurs pour toutes les propriétés et champs de données requis avant d’appeler Initialize.
Étant donné que l’extension de classe appelle votre pilote lors de l’initialisation, cette méthode peut également retourner des HRESULT que votre pilote retourne à partir de ISensorDriver ::OnGetSupportedSensorObjects.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Windows |
| d’en-tête | sensorsclassextension.h |
| bibliothèque | SensorsClassExtension.lib |