Funzione WdfIoResourceListInsertDescriptor (wdfresource.h)
[Si applica solo a KMDF]
Il metodo WdfIoResourceListInsertDescriptor inserisce un descrittore di risorsa nella configurazione logica dell'elenco dei requisiti delle risorse.
Sintassi
NTSTATUS WdfIoResourceListInsertDescriptor(
[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 . Per aggiungere un descrittore di risorse alla fine della configurazione logica, specificare WDF_INSERT_AT_END o il valore restituito da WdfIoResourceListGetCount.
Valore restituito
WdfIoResourceListInsertDescriptor restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questo metodo potrebbe restituire uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
|
È stato specificato un parametro non valido. |
|
Il driver non è stato autorizzato ad aggiungere descrittori alla configurazione logica. |
|
Il framework non è riuscito ad allocare spazio per archiviare il descrittore. |
|
Valore specificato dal parametro Index troppo grande. |
Un controllo dei bug di sistema si verifica se il driver fornisce un handle di oggetto non valido.
Commenti
Il metodo WdfIoResourceListInsertDescriptor inserisce il descrittore di risorsa a cui punta il parametro Descriptor nella configurazione logica specificata dal parametro ResourceList , davanti al descrittore di risorsa identificato dal valore Index .
Per aggiungere un descrittore di risorse alla fine di una configurazione logica, specificare WDF_INSERT_AT_END o il valore restituito da WdfIoResourceListGetCount per il valore index . In alternativa, usare il metodo WdfIoResourceListAppendDescriptor .
Il framework copia il contenuto della struttura IO_RESOURCE_DESCRIPTOR in una risorsa di archiviazione interna, quindi la routine del driver che chiama WdfIoResourceListInsertDescriptor può allocare la struttura in locale. Dopo che il driver chiama WdfIoResourceListInsertDescriptor, il driver può riutilizzare la struttura IO_RESOURCE_DESCRIPTOR .
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 descrittore di risorsa e viene aggiunto il descrittore alla fine di una configurazione logica.
IO_RESOURCE_DESCRIPTOR descriptor;
RtlZeroMemory(&descriptor, sizeof(descriptor));
descriptor.Option = 0;
descriptor.Type = CmResourceTypePort;
descriptor.ShareDisposition = CmResourceShareDeviceExclusive;
descriptor.Flags = CM_RESOURCE_PORT_IO|CM_RESOURCE_PORT_16_BIT_DECODE;
descriptor.u.Port.Length = 1;
descriptor.u.Port.Alignment = 0x01;
descriptor.u.Port.MinimumAddress.QuadPart = 0;
descriptor.u.Port.MaximumAddress.QuadPart = 0xFFFF;
status = WdfIoResourceListInsertDescriptor(
logConfig,
&descriptor,
WDF_INSERT_AT_END
);
if (!NT_SUCCESS(status)) {
return status;
}
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) |