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 di 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 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 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 risorse, vedere Risorse hardware per driver Framework-Based.
Esempi
L'esempio di codice seguente rimuove il terzo descrittore di risorse dagli elenchi non elaborati e tradotti di risorse hardware ricevute da un EvtDeviceRemoveAddedResources funzione di callback.
NTSTATUS
MyEvtDeviceRemoveAddedResources(
WDFDEVICE Device,
WDFCMRESLIST ResourcesRaw,
WDFCMRESLIST ResourcesTranslated
)
{
...
WdfCmResourceListRemove(
ResourcesRaw,
2
);
WdfCmResourceListRemove(
ResourcesTranslated,
2
);
...
}
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) |