Funzione UrsIoResourceListAppendDescriptor (ursdevice.h)
Aggiunge il descrittore di risorsa specificato all'oggetto elenco di risorse di I/O specificato che gestisce i descrittori di risorse per il ruolo host o 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 della risorsa. Questo oggetto viene allocato dal framework e passato al driver client quando il framework richiama l'implementazione EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS del driver.
[in] Descriptor
Puntatore a IO_RESOURCE_DESCRIPTOR che contiene il descrittore della risorsa per il ruolo.
Valore restituito
Il metodo restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questo metodo potrebbe restituire un NTSTATUS codice di errore.
Osservazioni
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 il ruolo host e funzione elenchi di risorse. Nell'implementazione, il driver client deve enumerare tramite l'elenco dei requisiti e aggiungere il descrittore di risorsa (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.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 10 |
| server minimo supportato | Windows Server 2016 |
| piattaforma di destinazione | Finestre |
| versione minima di KMDF | 1.15 |
| intestazione | ursdevice.h (include Urscx.h) |
| libreria | Urscxstub.lib |
| IRQL | PASSIVE_LEVEL |