Funzione WdfDeviceInitSetDeviceType (wdfdevice.h)

  • Articolo

[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 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 a WdfDeviceCreate, vedere Creazione di un oggetto dispositivo Framework.

Il tipo di dispositivo specificato da un driver determina il valore di aumento della priorità predefinito usato dal framework quando il driver completa una richiesta di I/O. Per altre informazioni sui valori di aumento della priorità, vedere Specifica di incrementi 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 oggetti dispositivo durante l'installazione.

Esempio

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

WdfDeviceInitSetDeviceType(
                           DeviceInit,
                           FILE_DEVICE_SERIAL_PORT
                           );

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Intestazione wdfdevice.h (includere Wdf.h)
Libreria Wdf01000.sys (vedere Framework Library Versioning).
IRQL <= DISPATCH_LEVEL
Regole di conformità DDI ChildDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)