IStiUSD ::GetStatus, méthode (stiusd.h)
La méthode IStiUSD ::GetStatus d’un minidriver d’image continue retourne l’état d’un appareil toujours image.
Syntaxe
HRESULT GetStatus(
PSTI_DEVICE_STATUS pDevStatus
);
Paramètres
pDevStatus
Pointeur fourni par l’appelant vers une structure STI_DEVICE_STATUS.
Valeur de retour
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 dwSize et StatusMask membres de la structure STI_DEVICE_STATUS, et le minidriver doit fournir des valeurs pour le reste des membres de la structure.
Si le pilote a précédemment défini l’indicateur de STI_GENCAP_POLLING_NEEDED dans la structure STI_DEV_CAPS de l’appareil, la méthode IStiUSD ::GetStatus de l’appareil est le moyen par lequel l’analyseur d’événements détermine si un Événements d’appareil still Image 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 STI_DEVICE_STATUS fournie, le minidriver doit définir l’indicateur approprié dans le membre dwOnlineState de la structure.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | stiusd.h (include Stiusd.h) |