Funzione WdfDeviceInitSetIoType (wdfdevice.h)

  • Articolo

[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)

Vedi anche

IWDFDeviceInitialize2::SetIoTypePreference

WDF_DEVICE_IO_TYPE

WdfDeviceInitSetIoTypeEx