Compartilhar via


Função WdfIoResourceRequirementsListRemove (wdfresource.h)

[Aplica-se somente ao KMDF]

O método WdfIoResourceRequirementsListRemove remove uma configuração lógica de uma lista de requisitos de recurso.

Sintaxe

void WdfIoResourceRequirementsListRemove(
  [in] WDFIORESREQLIST RequirementsList,
  [in] ULONG           Index
);

Parâmetros

[in] RequirementsList

Um identificador para um objeto framework resource-requirements-list que representa a lista de requisitos de recursos de um dispositivo.

[in] Index

Um valor baseado em zero que é usado como um índice na lista de requisitos de recursos especificada por RequirementsList .

Retornar valor

Nenhum

Comentários

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

O método WdfIoResourceRequirementsListRemove remove a configuração lógica associada ao valor de índice especificado pelo parâmetro Index .

Quando WdfIoResourceRequirementsListRemove remove a configuração lógica que tem o valor de índice n, o valor de índice da próxima configuração lógica muda de n+1 para n.

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

Exemplos

O exemplo de código a seguir remove a segunda configuração lógica de uma lista de requisitos de recursos.

NTSTATUS
Example_EvtDeviceFilterRemoveResourceRequirements(
    IN WDFDEVICE Device,
    IN WDFIORESREQLIST RequirementsList
    )
{
...
    WdfIoResourceRequirementsListRemove(
                                        RequirementsList,
                                        1
                                        );
...
}

Requisitos

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

Confira também

WdfIoResourceRequirementsListRemoveByIoResList