Funzione WdfIoResourceListRemove (wdfresource.h)

Articolo
02/07/2025

[Si applica solo a KMDF]

Il metodo WdfIoResourceListRemove rimuove un descrittore di risorsa dal configurazione logica di un elenco dei requisiti delle risorse.

Sintassi

void WdfIoResourceListRemove(
  [in] WDFIORESLIST ResourceList,
  [in] ULONG        Index
);

Parametri

[in] ResourceList

Handle per un oggetto framework resource-range-list che rappresenta una configurazione logica delle risorse hardware per un dispositivo.

[in] Index

Valore in base zero utilizzato come indice nella configurazione logica specificata ResourceList.

Valore restituito

Nessuno

Osservazioni

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

Il metodo WdfIoResourceListRemove rimuove il descrittore di risorsa associato al valore di indice specificato dal parametro Index.

Quando WdfIoResourceListRemove rimuove il descrittore di risorsa con il valore di indice n, il valore di indice del descrittore di risorsa successivo cambia da n+1 a n.

Per altre informazioni sugli elenchi di requisiti delle risorse e sulle configurazioni logiche, vedere Risorse hardware per i driver Framework-Based.

Esempi

Nell'esempio di codice seguente viene rimosso il primo descrittore di risorse da una configurazione logica.

WdfIoResourceListRemove(
                        Reslist,
                        0
                        );

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.0
intestazione	wdfresource.h (include Wdf.h)
libreria	Wdf01000.sys (vedere Controllo delle versioni della libreria framework).
IRQL	<=DISPATCH_LEVEL
regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedere anche

WdfIoResourceListRemoveByDescriptor

Condividi tramite