Funzione UrsIoResourceListAppendDescriptor (ursdevice.h)
Aggiunge il descrittore di risorse specificato all'oggetto elenco di risorse di I/O specificato che gestisce i descrittori di risorse per l'host o il ruolo della funzione.
Sintassi
NTSTATUS UrsIoResourceListAppendDescriptor(
[in] URSIORESLIST IoResourceList,
[in] PIO_RESOURCE_DESCRIPTOR Descriptor
);
Parametri
[in] IoResourceList
Oggetto elenco di risorse I/O di un ruolo a cui viene aggiunto il descrittore di risorse. Questo oggetto viene allocato dal framework e passato al driver client quando il framework richiama l'implementazione del driver EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS .
[in] Descriptor
Puntatore a IO_RESOURCE_DESCRIPTOR che contiene il descrittore di risorse per il ruolo.
Valore restituito
Il metodo restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questo metodo potrebbe restituire un codice di errore NTSTATUS appropriato.
Commenti
Dopo che il driver client chiama UrsDeviceInitialize, il framework alloca la memoria per l'elenco dei requisiti delle risorse. Quando l'estensione della classe a doppio ruolo USB richiama l'implementazione del driver client di EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS, passa un handle WDFIORESREQLIST a tale elenco di requisiti insieme agli handle URSIORESLIST per gli elenchi di risorse del ruolo host e funzione. Nell'implementazione, il driver client deve enumerare tramite l'elenco dei requisiti e aggiungere il descrittore di risorse (se vuole usare tale risorsa) all'elenco di risorse per ogni ruolo.
Per aggiungere descrittori di risorse per un ruolo, il driver chiama UrsIoResourceListAppendDescriptor e specifica il descrittore e l'elenco di risorse a cui aggiungere la risorsa.
Per un esempio di codice, vedere EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS.
Per altre informazioni sugli elenchi dei requisiti delle risorse, vedere Gestione delle risorse hardware.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 10 |
| Server minimo supportato | Windows Server 2016 |
| Piattaforma di destinazione | Windows |
| Versione KMDF minima | 1.15 |
| Intestazione | ursdevice.h (include Urscx.h) |
| Libreria | Urscxstub.lib |
| IRQL | PASSIVE_LEVEL |