IWDFDevice2 ::GetDeviceStackIoTypePreference, méthode (wudfddi.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 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 WDF_DEVICE_IO_TYPE-typée. Cette valeur identifie la méthode d’accès à la mémoire tampon utilisée par l’infrastructure 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 WDF_DEVICE_IO_TYPE-typée. Cette valeur qui identifie la méthode d’accès à la mémoire tampon utilisée par l’infrastructure pour les demandes de contrôle d’E/S d’un appareil.
Valeur de retour
Aucun
Remarques
Si votre pilote appelle GetDeviceStackIoTypePreference avant que le gestionnaire PnP n’ait chargé tous les pilotes de l’appareil, les valeurs qui GetDeviceStackIoTypePreference récupère 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 l’infrastructure utilise pour un appareil.
WDF_DEVICE_IO_TYPE ReadWriteAccessMethod;
WDF_DEVICE_IO_TYPE IoControlAccessMethod;
Device2->GetDeviceStackIoTypePreference(&ReadWriteAccessMethod,
&IoControlAccessMethod);
Exigences
| Exigence | Valeur |
|---|---|
| fin du support | Indisponible dans UMDF 2.0 et versions ultérieures. |
| plateforme cible | Bureau |
| version minimale de UMDF | 1.9 |
| d’en-tête | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |