Funzione WdfPdoInitAssignRawDevice (wdfpdo.h)
[Si applica solo a KMDF]
Il metodo WdfPdoInitAssignRawDevice indica che il driver chiamante può supportare un dispositivo specificato in modalità non elaborata.
Sintassi
NTSTATUS WdfPdoInitAssignRawDevice(
[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 classe di installazione del dispositivo .
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.
Per altre informazioni, vedere la sezione Osservazioni seguente.
Valore restituito
Se l'operazione ha esito positivo, il metodo restituisce STATUS_SUCCESS. In caso contrario, restituisce STATUS_INVALID_PARAMETER.
Osservazioni:
Il driver deve chiamare WdfPdoInitAssignRawDevice prima di chiamare WdfDeviceCreate. Per altre informazioni sulla chiamata di WdfDeviceCreate, vedere Creating a Framework Device Object.
Il Registro di sistema può contenere valori che eseguono l'override dei valori specificati da un driver quando chiama WdfDeviceInitAssignSDLString, WdfDeviceInitSetDeviceType, WdfDeviceInitSetCharacteristicse WdfDeviceInitSetExclusive. Il metodo WdfPdoInitAssignRawDeviceparametro DeviceClassGuid specifica un GUID che identifica la sezione del Registro di sistema che contiene i valori di override. Il parametro DeviceClassGuid identifica solo una sezione del Registro di sistema e non imposta effettivamente la classe di installazione del dispositivo per il dispositivo. La sezione versione INF nel file INF del dispositivo e del driver imposta la classe di installazione del dispositivo. In genere, il GUID del parametro DeviceClassGuid deve corrispondere al GUID specificato dalla sezione versione INF .
Per altre informazioni sull'uso del Registro di sistema, vedere Impostazione delle proprietà del Registro di sistema oggetti dispositivo dopo l'installazione.
Esempi
Il frammento di codice seguente dell'esempio di driver kmdf_enumswitches indica che un driver può supportare il dispositivo specificato in modalità non elaborata.
NTSTATUS status;
DEFINE_GUID(GUID_DEVCLASS_MYUNIQUEID,
0xf149fe88, 0x f6cc, 0x47e3, 0x85, 0x94, 0xe2, 0xaa, 0xb6, 0xe0, 0x3b, 0xdf);
status = WdfPdoInitAssignRawDevice(
pDeviceInit,
&GUID_DEVCLASS_MYUNIQUEID
);
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| versione minima di KMDF | 1.0 |
| intestazione | wdfpdo.h (include Wdf.h) |
| Biblioteca | Wdf01000.sys (vedere Controllo delle versioni della libreria framework). |
| IRQL | PASSIVE_LEVEL |
| regole di conformità DDI | ChildDeviceInitAPI(kmdf), DriverCreate(kmdf), InitFreeDeviceCallback(kmdf), InitFreeDeviceCreate(kmdf), InitFreeNull(kmdf), KmdfIrql(( kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf), PdoInitFreeDeviceCallback(kmdf), PdoInitFreeDeviceCreate(kmdf) |