IWDFDevice2 ::GetDeviceStackIoTypePreference, méthode (wudfddi.h)
[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.]
La méthode GetDeviceStackIoTypePreference récupère les méthodes d’accès à la mémoire tampon que l’infrastructure utilise pour un appareil.
Syntaxe
void GetDeviceStackIoTypePreference(
[out] WDF_DEVICE_IO_TYPE *ReadWritePreference,
[out] WDF_DEVICE_IO_TYPE *IoControlPreference
);
Paramètres
[out] ReadWritePreference
Pointeur vers un emplacement alloué par le pilote qui reçoit une valeur de type WDF_DEVICE_IO_TYPE. Cette valeur identifie la méthode d’accès à la mémoire tampon que le framework utilise pour les demandes de lecture et d’écriture d’un appareil.
[out] IoControlPreference
Pointeur vers un emplacement alloué par le pilote qui reçoit une valeur de type WDF_DEVICE_IO_TYPE. Valeur qui identifie la méthode d’accès à la mémoire tampon que l’infrastructure utilise pour les demandes de contrôle d’E/S d’un appareil.
Valeur de retour
None
Remarques
Si votre pilote appelle GetDeviceStackIoTypePreference avant que le gestionnaire PnP ait chargé tous les pilotes de l’appareil, les valeurs récupérées par GetDeviceStackIoTypePreference peuvent ne pas être les valeurs qu’il utilise réellement.
Pour plus d’informations sur la façon dont l’infrastructure choisit une méthode d’accès à la mémoire tampon, consultez Comment UMDF choisit une méthode d’accès à la mémoire tampon pour une demande d’E/S.
Exemples
L’exemple de code suivant récupère les méthodes d’accès à la mémoire tampon que le framework utilise pour un appareil.
WDF_DEVICE_IO_TYPE ReadWriteAccessMethod;
WDF_DEVICE_IO_TYPE IoControlAccessMethod;
Device2->GetDeviceStackIoTypePreference(&ReadWriteAccessMethod,
&IoControlAccessMethod);
Configuration requise
| Condition requise | Valeur |
|---|---|
| Fin de la prise en charge | Non disponible dans UMDF 2.0 et versions ultérieures. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| Version UMDF minimale | 1,9 |
| En-tête | wudfddi.h (inclure Wudfddi.h) |
| DLL | WUDFx.dll |