Funzione UrsIoResourceListAppendDescriptor (ursdevice.h)

  • Articolo

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

Vedi anche

EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS

UrsDeviceInitialize