Funzione WdfCmResourceListRemove (wdfresource.h)

  • Articolo

[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)

Vedi anche

WdfCmResourceListRemoveByDescriptor