Funzione WdfIoResourceListCreate (wdfresource.h)
[Si applica solo a KMDF]
Il metodo WdfIoResourceListCreate crea una configurazione logica vuota, che può essere popolata e aggiunta a un elenco di requisiti delle risorse.
Sintassi
NTSTATUS WdfIoResourceListCreate(
[in] WDFIORESREQLIST RequirementsList,
[in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
[out] WDFIORESLIST *ResourceList
);
Parametri
[in] RequirementsList
Handle per un oggetto framework resource-requirements-list che rappresenta l'elenco dei requisiti delle risorse di un dispositivo.
[in, optional] Attributes
Puntatore a una struttura WDF_OBJECT_ATTRIBUTES allocata dal chiamante che contiene gli attributi per il nuovo oggetto. Il membro ParentObject della struttura deve essere NULL. Questo parametro è facoltativo e può essere WDF_NO_OBJECT_ATTRIBUTES.
[out] ResourceList
Handle per un oggetto framework resource-range-list che rappresenta la nuova configurazione logica.
Valore restituito
WdfIoResourceListCreate restituisce STATUS_SUCCESS se l'operazione ha esito positivo.
Per altri valori restituiti, vedere Framework Object Creation Errors.
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo dei bug di sistema.
Osservazioni
Per altre informazioni sugli elenchi di requisiti delle risorse e sulle configurazioni logiche, vedere Risorse hardware per i driver Framework-Based.
L'oggetto resource-requirements-list specificato dal chiamante diventa l'elemento padre del nuovo oggetto resource-range-list. Il driver non può modificare questo elemento padre e il membro ParentObject o la struttura WDF_OBJECT_ATTRIBUTES deve essere NULL.
Esempi
Per un esempio di codice che usa WdfIoResourceListCreate, vedere WdfIoResourceRequirementsListAppendIoResList.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| versione minima di KMDF | 1.0 |
| intestazione | wdfresource.h (include Wdf.h) |
| libreria | Wdf01000.sys (vedere Controllo delle versioni della libreria framework). |
| IRQL | <=DISPATCH_LEVEL |
| regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |