Função WdfIoResourceRequirementsListAppendIoResList (wdfresource.h)

Artigo
02/07/2025

[Aplica-se somente ao KMDF]

O método WdfIoResourceRequirementsListAppendIoResList adiciona uma configuração lógica ao final de uma lista de requisitos de recursos.

Sintaxe

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

Parâmetros

[in] RequirementsList

Um identificador para um objeto de lista de requisitos de recursos da estrutura que representa a lista de requisitos de recursos de um dispositivo.

[in] IoResList

Um identificador para um objeto de lista de intervalo de recursos da estrutura que representa uma configuração lógica de recursos de hardware para um dispositivo.

Valor de retorno

WdfIoResourceRequirementsListAppendIoResList retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, esse método poderá retornar um dos seguintes valores:

Código de retorno	Descrição
STATUS_INVALID_PARAMETER	Um parâmetro inválido foi especificado.
STATUS_INVALID_DEVICE_REQUEST	O objeto de lista de requisitos de recurso especificado não possui o objeto de lista de intervalo de recursos especificado.
STATUS_INSUFFICIENT_RESOURCES	A estrutura não pôde alocar espaço para armazenar o objeto resource-range-list.

Uma verificação de bugs do sistema ocorre se o driver fornece um identificador de objeto inválido.

Observações

Para obter mais informações sobre listas de requisitos de recursos, consulte Recursos de Hardware para drivers Framework-Based.

Exemplos

O exemplo de código a seguir mostra como uma função de retorno de chamada EvtDeviceResourceRequirementsQuery cria uma configuração lógica vazia e a acrescenta a uma lista de requisitos de recursos.

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;
    }
...
}

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
versão mínima do KMDF	1.0
cabeçalho	wdfresource.h (inclua Wdf.h)
biblioteca	Wdf01000.sys (consulte o Controle de Versão da Biblioteca da Estrutura.)
IRQL	<=DISPATCH_LEVEL
regras de conformidade de DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte também

WdfIoResourceListCreate

WdfIoResourceRequirementsListInsertIoResList

Compartilhar via