Funzione WdfIoResourceListCreate (wdfresource.h)

  • Articolo

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

Vedi anche

WDF_OBJECT_ATTRIBUTES