Funzione WdfDeviceInitSetDeviceType (wdfdevice.h)

Articolo
02/07/2025

[Si applica solo a KMDF]

Il metodo WdfDeviceInitSetDeviceType imposta il tipo di dispositivo per un dispositivo specificato.

Sintassi

void WdfDeviceInitSetDeviceType(
  [in] PWDFDEVICE_INIT DeviceInit,
  [in] DEVICE_TYPE     DeviceType
);

Parametri

[in] DeviceInit

Puntatore a una struttura WDFDEVICE_INIT.

[in] DeviceType

Valore FILE_DEVICE_XXXX che identifica il tipo di dispositivo. Per altre informazioni sui valori di FILE_DEVICE_XXXX, vedere Specifica dei tipi di dispositivo.

Valore restituito

Nessuno

Osservazioni

Se un driver chiama WdfDeviceInitSetDeviceType, deve farlo prima di chiamare WdfDeviceCreate.

Per altre informazioni sulla chiamata di WdfDeviceCreate, vedere Creating a Framework Device Object.

Il tipo di dispositivo specificato da un driver determina il valore di priorità predefinito usato dal framework quando il driver completa una richiesta di I/O. Per altre informazioni sui valori di priorità, vedere Specifica di boost di priorità durante il completamento delle richieste di I/O.

Se si scrive un driver UMDF, è necessario modificare il file INF del driver o apportare modifiche al Registro di sistema per specificare un tipo di dispositivo. Per altre informazioni sull'uso del Registro di sistema, vedere Impostazione delle proprietà del Registro di sistema degli oggetti dispositivo durante l'installazione.

Esempi

L'esempio di codice seguente indica che un dispositivo è un dispositivo seriale.

WdfDeviceInitSetDeviceType(
                           DeviceInit,
                           FILE_DEVICE_SERIAL_PORT
                           );

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.0
intestazione	wdfdevice.h (include Wdf.h)
libreria	Wdf01000.sys (vedere Controllo delle versioni della libreria framework).
IRQL	<= DISPATCH_LEVEL
regole di conformità DDI	ChildDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql() kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Condividi tramite