Funzione WdfIoResourceRequirementsListAppendIoResList (wdfresource.h)

Articolo
02/29/2024

[Si applica solo a KMDF]

Il metodo WdfIoResourceRequirementsListAppendIoResList aggiunge una configurazione logica alla fine di un elenco di requisiti delle risorse.

Sintassi

NTSTATUS WdfIoResourceRequirementsListAppendIoResList(
  [in] WDFIORESREQLIST RequirementsList,
  [in] WDFIORESLIST    IoResList
);

Parametri

[in] RequirementsList

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

[in] IoResList

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

Valore restituito

WdfIoResourceRequirementsListAppendIoResList restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questo metodo potrebbe restituire uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_INVALID_PARAMETER	È stato specificato un parametro non valido.
STATUS_INVALID_DEVICE_REQUEST	L'oggetto resource-requirements-list specificato non è proprietario dell'oggetto resource-range-list specificato.
STATUS_INSUFFICIENT_RESOURCES	Il framework non è riuscito ad allocare spazio per archiviare l'oggetto resource-range-list.

Un controllo dei bug di sistema si verifica se il driver fornisce un handle di oggetto non valido.

Commenti

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

Esempio

Nell'esempio di codice seguente viene illustrato come una funzione di callback EvtDeviceResourceRequirementsQuery crei una configurazione logica vuota e la accoda a un elenco dei requisiti delle risorse.

NTSTATUS
Example_EvtDeviceResourceRequirementsQuery(
    IN WDFDEVICE Device,
    IN WDFIORESREQLIST RequirementsList
    )
{
    NTSTATUS  status;
    WDFIORESLIST  logConfig;

    status = WdfIoResourceListCreate(
                                     RequirementsList,
                                     WDF_NO_OBJECT_ATTRIBUTES,
                                     &logConfig
                                     );
    if (!NT_SUCCESS(status)) {
        return status;
    }

    status = WdfIoResourceRequirementsListAppendIoResList(
                                             RequirementsList,
                                             logConfig
                                             );
    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)

Vedi anche

WdfIoResourceListCreate

WdfIoResourceRequirementsListInsertIoResList

Condividi tramite