Funzione WdfIoResourceRequirementsListRemove (wdfresource.h)

Articolo
02/07/2025

[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 framework resource-requirements-list che rappresenta l'elenco dei requisiti delle risorse di un dispositivo.

[in] Index

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

Valore restituito

Nessuno

Osservazioni

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

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 Framework-Based.

Esempi

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

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

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

WdfIoResourceRequirementsListRemoveByIoResList

Condividi tramite