Funzione WdfCmResourceListRemove (wdfresource.h)
[Si applica solo a KMDF]
Il metodo WdfCmResourceListRemove rimuove un descrittore di risorse da un elenco di risorse specificato.
Sintassi
void WdfCmResourceListRemove(
[in] WDFCMRESLIST List,
[in] ULONG Index
);
Parametri
[in] List
Handle per un oggetto elenco risorse framework che rappresenta un elenco di risorse hardware per un dispositivo.
[in] Index
Valore in base zero utilizzato come indice nell'elenco di risorse specificato da List .
Valore restituito
nessuno
Osservazioni
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.
Il metodo WdfCmResourceListRemove rimuove il descrittore di risorsa associato al valore di indice specificato dal parametro Index .
Quando WdfCmResourceListRemove rimuove il descrittore di risorse 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 risorse, vedere Risorse hardware per i driver Framework-Based.
Esempio
L'esempio di codice seguente rimuove il terzo descrittore di risorse dagli elenchi non elaborati e tradotti di risorse hardware ricevute da una funzione di callback EvtDeviceRemoveAddedResources .
NTSTATUS
MyEvtDeviceRemoveAddedResources(
WDFDEVICE Device,
WDFCMRESLIST ResourcesRaw,
WDFCMRESLIST ResourcesTranslated
)
{
...
WdfCmResourceListRemove(
ResourcesRaw,
2
);
WdfCmResourceListRemove(
ResourcesTranslated,
2
);
...
}
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 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) |