IWDFUsbTargetDevice ::SetPowerPolicy, méthode (wudfusb.h)
[Avertissement : UMDF 2 est la dernière version de UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide de UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et il existe une prise en charge limitée de UMDF 1 sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Bien démarrer avec UMDF.]
La méthode SetPowerPolicy définit la stratégie d’alimentation WinUsb.
Syntaxe
HRESULT SetPowerPolicy(
[in] ULONG PolicyType,
[in] ULONG ValueLength,
[in] PVOID Value
);
Paramètres
[in] PolicyType
Type de stratégie d’alimentation WinUsb définie par le pilote UMDF.
[in] ValueLength
Taille, en octets, de la mémoire tampon qui SetPowerPolicy fournit dans Valeur.
[in] Value
Pointeur vers la mémoire tampon qui contient la stratégie d’alimentation WinUsb.
Valeur de retour
SetPowerPolicy retourne l’une des valeurs suivantes :
| Retourner le code | Description |
|---|---|
|
SetPowerPolicy définir correctement la stratégie d’alimentation WinUsb. |
|
SetPowerPolicy a rencontré un échec d’allocation. |
|
Cette valeur correspond au code d’erreur retourné par l’API WinUsb. |
Remarques
La stratégie d’alimentation contrôle la gestion de l’alimentation effectuée par WinUsb pour l’appareil.
Pour plus d’informations sur les types et valeurs de stratégie valides qu’un pilote UMDF peut passer pour les paramètres PolicyType et Valeur, consultez la fonction WinUsb_SetPowerPolicy.
Pour plus d’informations sur le comportement de l’alimentation de WinUSB, consultez Gestion de l’alimentation WinUSB.
La méthode SetPowerPolicy génère une requête UMDF et envoie de manière synchrone la requête à la cible d’E/S.
Exigences
| Exigence | Valeur |
|---|---|
| fin du support | Indisponible dans UMDF 2.0 et versions ultérieures. |
| plateforme cible | Bureau |
| version minimale de UMDF | 1.5 |
| d’en-tête | wudfusb.h (include Wudfusb.h) |
| DLL | WUDFx.dll |