fonction WinUsb_GetPipePolicy (winusb.h)

Article
08/27/2023

La fonction WinUsb_GetPipePolicy récupère la stratégie pour un canal spécifique associé à un point de terminaison sur l’appareil. Il s’agit d’une opération synchrone.

Syntaxe

BOOL WinUsb_GetPipePolicy(
  [in]      WINUSB_INTERFACE_HANDLE InterfaceHandle,
  [in]      UCHAR                   PipeID,
  [in]      ULONG                   PolicyType,
  [in, out] PULONG                  ValueLength,
  [out]     PVOID                   Value
);

Paramètres

[in] InterfaceHandle

Handle opaque pour une interface qui contient le point de terminaison auquel le canal est associé.

Pour interroger le canal associé au point de terminaison dans la première interface, utilisez le handle retourné par WinUsb_Initialize. Pour toutes les autres interfaces, utilisez le handle de l’interface cible, récupéré par WinUsb_GetAssociatedInterface.

[in] PipeID

Valeur 8 bits qui se compose d’une adresse 7 bits et d’un bit de direction. Ce paramètre correspond au champ bEndpointAddress dans le descripteur de point de terminaison.

[in] PolicyType

Variable ULONG qui spécifie le paramètre de stratégie à récupérer. La valeur actuelle du paramètre de stratégie est récupérée le paramètre Value . Pour plus d’informations sur le comportement des stratégies de canal, consultez WinUSB Functions for Pipe Policy Modification.

[in, out] ValueLength

Pointeur vers la taille, en octets, de la mémoire tampon vers laquelle value pointe. À la sortie, ValueLength reçoit la taille, en octets, des données qui ont été copiées dans la mémoire tampon Value .

[out] Value

Pointeur vers une mémoire tampon qui reçoit la valeur de stratégie de canal spécifiée.

Valeur retournée

WinUsb_GetPipePolicy retourne TRUE si l’opération réussit. Sinon, cette routine retourne FALSE et l’appelant peut récupérer l’erreur journalisée en appelant GetLastError.

GetLastError peut retourner le code d’erreur suivant.