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 dei 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 resource-requirements-list framework 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 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 a un oggetto resource-range-list framework che rappresenta la nuova configurazione logica.
Valore restituito
WdfIoResourceListCreate restituisce STATUS_SUCCESS se l'operazione ha esito positivo.
Per altri valori restituiti, vedere Errori di creazione di oggetti Framework.
Un controllo del bug di sistema si verifica se il driver fornisce un handle di oggetti non valido.
Commenti
Per altre informazioni sugli elenchi di requisiti delle risorse e sulle configurazioni logiche, vedere Risorse hardware per i driver di 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.
Esempio
Per un esempio di codice che usa WdfIoResourceListCreate, vedere WdfIoResourceRequirementsListAppendIoResList.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.0 |
| Intestazione | wdfresource.h (includere Wdf.h) |
| Libreria | Wdf01000.sys (vedere Framework Library Versioning). |
| IRQL | <=DISPATCH_LEVEL |
| Regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |