IWDFUsbTargetPipe ::RetrievePipePolicy, 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 RetrievePipePolicy récupère une stratégie de canal WinUsb.
Syntaxe
HRESULT RetrievePipePolicy(
[in] ULONG PolicyType,
[in, out] ULONG *ValueLength,
[out] PVOID Value
);
Paramètres
[in] PolicyType
Type de stratégie de canal WinUsb que le pilote UMDF demande.
[in, out] ValueLength
Pointeur vers une variable qui, en entrée, contient la taille, en octets, de la mémoire tampon qui RetrievePipePolicy fournit pour valeur. En sortie, ce paramètre contient la taille requise RetrievePipePolicy pour valeur.
[out] Value
Pointeur qui reçoit la mémoire tampon qui contient la stratégie de canal WinUsb.
Valeur de retour
RetrievePipePolicy retourne l’une des valeurs suivantes :
| Retourner le code | Description |
|---|---|
|
RetrievePipePolicy récupéré avec succès la stratégie de canal WinUsb. |
|
RetrievePipePolicy a rencontré un échec d’allocation. |
|
Cette valeur correspond au code d’erreur retourné par l’API WinUsb. |
Remarques
La stratégie de canal contrôle le comportement du canal USB (par exemple, les délais d’attente, la gestion des paquets courts, etc.).
Pour plus d’informations sur les types de stratégie valides qu’un pilote UMDF peut passer pour le paramètre PolicyType et les valeurs retournées par l’infrastructure, consultez la fonction WinUsb_GetPipePolicy.
Pour plus d’informations sur le comportement des stratégies de canal, consultez fonctions WinUSB pour la modification de la stratégie de canal.
La méthode RetrievePipePolicy 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 |