WDF_IO_TYPE_CONFIG struttura (wdfdevice.h)

[Si applica a KMDF e UMDF]

La struttura WDF_IO_TYPE_CONFIG specifica il metodo di accesso al buffer preferito del driver per le richieste di lettura e scrittura e per le richieste di controllo I/O del dispositivo.

Sintassi

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;

Members

Size

Dimensioni di questa struttura in byte.

ReadWriteIoType

KMDF Enumeratore WDF_DEVICE_IO_TYPE tipizzato che identifica il metodo usato dal driver per accedere ai buffer di dati ricevuti per le richieste di lettura e scrittura.

UMDF Enumeratore WDF_DEVICE_IO_TYPE tipizzato che identifica il metodo che si preferisce usare per accedere ai buffer di dati di richieste di lettura e scrittura. I valori validi includono WdfDeviceIoBuffered e WdfDeviceIoDirect.

DeviceControlIoType

Questo membro non si applica a KMDF.

UMDF Enumeratore WDF_DEVICE_IO_TYPE tipizzato che identifica il metodo che si preferisce usare per i buffer di dati delle richieste IOCTL. I valori validi includono WdfDeviceIoBuffered e WdfDeviceIoDirect.

DirectTransferThreshold

Questo membro non si applica a KMDF.

UMDF Valore facoltativo che specifica le dimensioni del buffer più piccole, in byte, per cui il framework userà l'I/O diretto per un dispositivo. Ad esempio, impostare DirectTransferThreshold su 12288 per indicare che il framework deve usare l'I/O con buffer per tutti i buffer più piccoli di 12 kilobyte e indirizzare I/O per i buffer uguali o superiori a 12 kilobyte. In genere, non è necessario fornire questo valore perché il framework usa le impostazioni che forniscono le migliori prestazioni.

Commenti

La struttura WDF_IO_TYPE_CONFIG viene usata come input per il metodo WdfDeviceInitSetIoTypeEx .

Per inizializzare una struttura WDF_IO_TYPE_CONFIG , il driver deve chiamare WDF_IO_TYPE_CONFIG_INIT.

Se si scrive un driver usando UMDF versione 2.0 o successiva, vedere Gestione dei metodi di accesso al buffer nei driver UMDF per altre informazioni sulla specifica dei metodi di accesso al buffer preferiti.

Se si scrive un driver usando UMDF versione 1. x, il driver chiama IWDFDeviceInitialize2::SetIoTypePreference per specificare i metodi di accesso al buffer preferiti.

Requisiti

Requisito	Valore
Versione KMDF minima	1.13
Versione UMDF minima	2,0
Intestazione	wdfdevice.h (includere Wdf.h)

Vedi anche

WDF_DEVICE_IO_TYPE

WDF_IO_TYPE_CONFIG_INIT

WdfDeviceInitSetIoTypeEx