Funzione WdfDeviceInitSetDeviceClass (wdfdevice.h)

Articolo
02/07/2025

[Si applica solo a KMDF]

Il metodo WdfDeviceInitSetDeviceClass specifica un GUID che identifica la classe di installazione del dispositivo dispositivo.

Sintassi

void WdfDeviceInitSetDeviceClass(
  [in] PWDFDEVICE_INIT DeviceInit,
  [in] const GUID      *DeviceClassGuid
);

Parametri

[in] DeviceInit

Puntatore a una struttura WDFDEVICE_INIT.

[in] DeviceClassGuid

Puntatore a un GUID che identifica una sezione del Registro di sistema contenente possibili override per il DefaultSDDLString, DeviceType, DeviceCharacteristicse parametri esclusivi.

Nota È consigliabile specificare sempre un GUID di classe personalizzato. Non è consigliabile specificare un GUID di classe esistente. Se si specifica un GUID di classe esistente, altri driver che tentano di specificare che il GUID della classe esistente potrebbe non essere installato o potrebbe non essere installato con impostazioni di sicurezza non corrette.

Valore restituito

Nessuno

Osservazioni

Il Registro di sistema può contenere valori che eseguono l'override dei valori specificati da un driver quando chiama WdfDeviceInitAssignSDLString, WdfDeviceInitSetDeviceType, WdfDeviceInitSetCharacteristicse WdfDeviceInitSetExclusive. Il driver può chiamare WdfDeviceInitSetDeviceClass per specificare un GUID che identifica la sezione del Registro di sistema che contiene i valori di override.

In genere, un driver chiama WdfDeviceInitSetDeviceClass solo se crea un dispositivo di controllo .

Per altre informazioni sull'uso del Registro di sistema, vedere Impostazione delle proprietà del Registro di sistema oggetti dispositivo dopo l'installazione.

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

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

Esempi

L'esempio di codice seguente imposta la classe di installazione di un dispositivo sulla classe del dispositivo di sistema.

DEFINE_GUID(GUID_DEVCLASS_MYUNIQUEID,
0xf149fe88, 0x f6cc, 0x47e3, 0x85, 0x94, 0xe2, 0xaa, 0xb6, 0xe0, 0x3b, 0xdf);

WdfDeviceInitSetDeviceClass(
                            DeviceInit,
                            &GUID_DEVCLASS_MYUNIQUEID
                            );

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), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Condividi tramite