Funzione WdfIoResourceRequirementsListRemove (wdfresource.h)

[Si applica solo a KMDF]

Il metodo WdfIoResourceRequirementsListRemove rimuove una configurazione logica da un elenco dei requisiti delle risorse.

Sintassi

void WdfIoResourceRequirementsListRemove(
  [in] WDFIORESREQLIST RequirementsList,
  [in] ULONG           Index
);

Parametri

[in] RequirementsList

Handle per un oggetto resource-requirements-list framework che rappresenta l'elenco dei requisiti delle risorse di un dispositivo.

[in] Index

Valore in base zero utilizzato come indice nell'elenco dei requisiti delle risorse specificato da RequirementsList .

Valore restituito

nessuno

Osservazioni

Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.

Il metodo WdfIoResourceRequirementsListRemove rimuove la configurazione logica associata al valore di indice specificato dal parametro Index .

Quando WdfIoResourceRequirementsListRemove rimuove la configurazione logica con il valore di indice n, il valore di indice della configurazione logica successiva cambia da n+1 a n.

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

Esempio

Nell'esempio di codice seguente viene rimossa la seconda configurazione logica da un elenco dei requisiti delle risorse.

NTSTATUS
Example_EvtDeviceFilterRemoveResourceRequirements(
    IN WDFDEVICE Device,
    IN WDFIORESREQLIST RequirementsList
    )
{
...
    WdfIoResourceRequirementsListRemove(
                                        RequirementsList,
                                        1
                                        );
...
}

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Intestazione wdfresource.h (includere Wdf.h)
Libreria Wdf01000.sys (vedere Framework Library Versioning).
IRQL <=DISPATCH_LEVEL
Regole di conformità DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

WdfIoResourceRequirementsListRemoveByIoResList