Funzione WdfDeviceInitSetDeviceClass (wdfdevice.h)

Articolo
02/29/2024

[Si applica solo a KMDF]

Il metodo WdfDeviceInitSetDeviceClass specifica un GUID che identifica la classe di configurazione del dispositivo del 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 sostituzioni per i parametri DefaultSDDLString, DeviceType, DeviceCharacteristics ed Exclusive .

Nota È sempre necessario specificare 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 WdfDeviceInitAssignSDDLString, WdfDeviceInitSetDeviceType, WdfDeviceInitSetCharacteristics e 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 oggetti dispositivo dopo l'installazione.

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

Per altre informazioni sulla chiamata a WdfDeviceCreate, vedere Creazione di un oggetto dispositivo framework.

Esempio

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

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	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