Funzione WdfIoResourceListUpdateDescriptor (wdfresource.h)

Articolo
02/07/2025

[Si applica solo a KMDF]

Il metodo WdfIoResourceListUpdateDescriptor aggiorna un descrittore di risorse nell'elenco dei requisiti delle risorse configurazione logica.

Sintassi

void WdfIoResourceListUpdateDescriptor(
  [in] WDFIORESLIST            ResourceList,
  [in] PIO_RESOURCE_DESCRIPTOR Descriptor,
  [in] ULONG                   Index
);

Parametri

[in] ResourceList

Handle per un oggetto framework resource-range-list che rappresenta una configurazione logica delle risorse hardware per un dispositivo.

[in] Descriptor

Puntatore a una struttura IO_RESOURCE_DESCRIPTOR che descrive una risorsa hardware.

[in] Index

Valore in base zero usato come indice nel set di descrittori di risorse già presenti nella configurazione logica specificata ResourceList.

Valore restituito

Nessuno

Osservazioni

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

Il metodo WdfIoResourceListUpdateDescriptor individua il descrittore di risorsa identificato dal parametro Index. Il metodo copia quindi il descrittore della risorsa specificato dal descrittore di parametro nel descrittore specificato Index.

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

Esempi

Nell'esempio di codice seguente viene inizializzato un nuovo descrittore di risorse e quindi viene chiamato WdfIoResourceListUpdateDescriptor per sostituire il secondo descrittore in una configurazione logica con il nuovo descrittore.

IO_RESOURCE_DESCRIPTOR newDescriptor;

RtlZeroMemory(
              &newDescriptor,
              sizeof(newDescriptor)
              );

newDescriptor.Option = 0;
newDescriptor.Type = CmResourceTypePort;
newDescriptor.ShareDisposition = CmResourceShareDeviceExclusive;
newDescriptor.Flags = CM_RESOURCE_PORT_IO|CM_RESOURCE_PORT_16_BIT_DECODE;
newDescriptor.u.Port.Length = 1;
newDescriptor.u.Port.Alignment = 0x01;
newDescriptor.u.Port.MinimumAddress.QuadPart = 0;
newDescriptor.u.Port.MaximumAddress.QuadPart = 0xFFFF;

WdfIoResourceListUpdateDescriptor(
                                  Reslist,
                                  &newDescriptor,
                                  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

IO_RESOURCE_DESCRIPTOR

Condividi tramite