Funzione WdfIoResourceListUpdateDescriptor (wdfresource.h)
[Si applica solo a KMDF]
Il metodo WdfIoResourceListUpdateDescriptor aggiorna un descrittore di risorse nella configurazione logica dell'elenco dei requisiti delle risorse.
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 da 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 di risorsa specificato dal parametro Descriptor nel descrittore specificato da Index .
Per altre informazioni sugli elenchi di requisiti delle risorse e sulle configurazioni logiche, vedere Risorse hardware per i driver Framework-Based.
Esempio
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
);
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) |