Funzione WdfDeviceInitSetIoType (wdfdevice.h)
[Si applica a KMDF e UMDF]
Il metodo WdfDeviceInitSetIoType imposta il metodo o la preferenza per il modo in cui un driver accederà ai buffer di dati inclusi nelle richieste di lettura e scrittura per un dispositivo specificato.
Sintassi
void WdfDeviceInitSetIoType(
[in] PWDFDEVICE_INIT DeviceInit,
[in] WDF_DEVICE_IO_TYPE IoType
);
Parametri
[in] DeviceInit
Puntatore a una struttura WDFDEVICE_INIT .
[in] IoType
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.
Valore restituito
nessuno
Osservazioni
KMDF Se si scrive un nuovo driver usando KMDF versione 1.13 o successiva, è consigliabile usare invece WdfDeviceInitSetIoTypeEx. La chiamata a WdfDeviceInitSetIoType da un driver di filtro KMDF non ha alcun effetto. Per i driver di filtro, il framework usa il tipo di I/O specificato dal driver inferiore successivo nello stack di driver.
UMDF Se si converte un driver KMDF che chiama WdfDeviceInitSetIoType in UMDF versione 2.0 o successiva, il driver convertito può continuare a chiamare WdfDeviceInitSetIoType senza problemi. Tuttavia, se si scrive un driver completamente nuovo usando UMDF versione 2.0 o successiva, è consigliabile usare invece WdfDeviceInitSetIoTypeEx.
Se un driver chiama WdfDeviceInitSetIoType, deve farlo prima di chiamare WdfDeviceCreate. Per altre informazioni sulla chiamata a WdfDeviceCreate, vedere Creazione di un oggetto dispositivo Framework.
Se il driver non chiama WdfDeviceInitSetIoType, il framework imposta il metodo di accesso al buffer del driver su WdfDeviceIoBuffered per il dispositivo specificato.
Per altre informazioni sui metodi di accesso al buffer, vedere Accesso ai buffer dei dati.
Esempio
L'esempio di codice seguente indica che un driver userà il metodo I/O diretto quando accede al dispositivo.
WdfDeviceInitSetIoType(
DeviceInit,
WdfDeviceIoDirect
);
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.0 |
| Versione UMDF minima | 2,0 |
| Intestazione | wdfdevice.h (includere Wdf.h) |
| Libreria | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | <= DISPATCH_LEVEL |
| Regole di conformità DDI | ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf) |