Méthode IStiUSD ::GetStatus (stiusd.h)
La méthode IStiUSD ::GetStatus d’un minidriver d’image fixe retourne la status d’un appareil d’image fixe.
Syntaxe
HRESULT GetStatus(
PSTI_DEVICE_STATUS pDevStatus
);
Paramètres
pDevStatus
Pointeur fourni par l’appelant vers une structure STI_DEVICE_STATUS .
Valeur retournée
Si l’opération réussit, la méthode doit retourner S_OK. Sinon, il doit retourner l’un des codes d’erreur préfixés STIERR définis dans stierr.h.
Remarques
L’appelant fournit des valeurs pour les membres dwSize et StatusMask de la structure STI_DEVICE_STATUS , et le minidriver doit fournir des valeurs pour les autres membres de la structure.
Si le pilote a précédemment défini l’indicateur STI_GENCAP_POLLING_NEEDED dans la structure de STI_DEV_CAPS de l’appareil, la méthode IStiUSD ::GetStatus du minidriver est le moyen par lequel le moniteur d’événements détermine si un événement d’appareil image fixe s’est produit. Le moniteur d’événements appelle la méthode, en spécifiant STI_DEVSTATUS_EVENT_STATE dans la structure de STI_DEVICE_STATUS fournie. Le pilote doit interroger l’appareil et définir STI_EVENTHANDLING_PENDING si un événement s’est produit.
Si l’appelant spécifie STI_DEVSTATUS_ONLINE_STATE dans la structure de STI_DEVICE_STATUS fournie, le minidriver doit définir l’indicateur approprié dans le membre dwOnlineState de la structure.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | stiusd.h (inclure Stiusd.h) |