Partager via

IWDFDevice2 ::GetDeviceStackIoTypePreference, méthode (wudfddi.h)

  • Article

[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

Voir aussi

IWDFDevice2

IWDFDeviceInitialize2 ::SetIoTypePreference