structure WDF_IO_TYPE_CONFIG (wdfdevice.h)

[S’applique à KMDF et UMDF]

La structure WDF_IO_TYPE_CONFIG spécifie la méthode d’accès à la mémoire tampon préférée du pilote pour les demandes de lecture et d’écriture et pour les demandes de contrôle d’E/S d’appareil.

Syntaxe

typedef struct _WDF_IO_TYPE_CONFIG {
  ULONG              Size;
  WDF_DEVICE_IO_TYPE ReadWriteIoType;
  WDF_DEVICE_IO_TYPE DeviceControlIoType;
  ULONG              DirectTransferThreshold;
} WDF_IO_TYPE_CONFIG, *PWDF_IO_TYPE_CONFIG;

Membres

Size

Taille de cette structure en octets.

ReadWriteIoType

KMDF Énumérateur WDF_DEVICE_IO_TYPE qui identifie la méthode que le pilote utilisera pour accéder aux mémoires tampons de données qu’il reçoit pour les demandes de lecture et d’écriture.

UMDF Énumérateur de type WDF_DEVICE_IO_TYPE qui identifie la méthode que vous préférez utiliser pour accéder aux mémoires tampons de données des demandes de lecture et d’écriture. Les valeurs valides incluent WdfDeviceIoBuffered et WdfDeviceIoDirect.

DeviceControlIoType

Ce membre ne s’applique pas à KMDF.

UMDF Énumérateur WDF_DEVICE_IO_TYPE qui identifie la méthode que vous préférez utiliser pour les mémoires tampons de données des requêtes IOCTL. Les valeurs valides incluent WdfDeviceIoBuffered et WdfDeviceIoDirect.

DirectTransferThreshold

Ce membre ne s’applique pas à KMDF.

UMDF Valeur facultative qui spécifie la plus petite taille de mémoire tampon, en octets, pour laquelle l’infrastructure utilisera les E/S directes pour un appareil. Par exemple, définissez DirectTransferThreshold sur 12288 pour indiquer que l’infrastructure doit utiliser les E/S mises en mémoire tampon pour toutes les mémoires tampons inférieures à 12 kilo-octets, et les E/S directes pour les mémoires tampons supérieures ou égales à 12 kilo-octets. En règle générale, vous n’avez pas besoin de fournir cette valeur, car l’infrastructure utilise des paramètres qui fournissent les meilleures performances.

Remarques

La structure WDF_IO_TYPE_CONFIG est utilisée comme entrée dans la méthode WdfDeviceInitSetIoTypeEx .

Pour initialiser une structure de WDF_IO_TYPE_CONFIG , votre pilote doit appeler WDF_IO_TYPE_CONFIG_INIT.

Si vous écrivez un pilote à l’aide d’UMDF version 2.0 ou ultérieure, consultez Gestion des méthodes d’accès à la mémoire tampon dans les pilotes UMDF pour plus d’informations sur la spécification des méthodes d’accès à la mémoire tampon préférées.

Si vous écrivez un pilote à l’aide d’UMDF version 1. x, votre pilote appelle IWDFDeviceInitialize2 ::SetIoTypePreference pour spécifier les méthodes d’accès à la mémoire tampon préférées.

Configuration requise

Condition requise	Valeur
Version KMDF minimale	1.13
Version UMDF minimale	2.0
En-tête	wdfdevice.h (include Wdf.h)

Voir aussi

WDF_DEVICE_IO_TYPE

WDF_IO_TYPE_CONFIG_INIT

WdfDeviceInitSetIoTypeEx