Compartilhar via

Função WdfCmResourceListRemove (wdfresource.h)

  • Artigo

[Aplica-se somente ao KMDF]

O método WdfCmResourceListRemove remove um descritor de recursos de uma lista de recursos especificada.

Sintaxe

void WdfCmResourceListRemove(
  [in] WDFCMRESLIST List,
  [in] ULONG        Index
);

Parâmetros

[in] List

Um identificador para um objeto de lista de recursos de estrutura que representa uma lista de recursos de hardware para um dispositivo.

[in] Index

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

Retornar valor

Nenhum

Comentários

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

O método WdfCmResourceListRemove remove o descritor de recurso associado ao valor de índice especificado pelo parâmetro Index .

Quando WdfCmResourceListRemove remove o descritor de recurso que tem o valor de índice n, o valor de índice do próximo descritor de recurso muda de n+1 para n.

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

Exemplos

O exemplo de código a seguir remove o terceiro descritor de recursos das listas brutas e traduzidas de recursos de hardware que uma função de retorno de chamada EvtDeviceRemoveAddedResources recebe.

NTSTATUS
MyEvtDeviceRemoveAddedResources(
    WDFDEVICE Device,
    WDFCMRESLIST ResourcesRaw,
    WDFCMRESLIST ResourcesTranslated
    )
{
...
    WdfCmResourceListRemove(
                            ResourcesRaw,
                            2
                            );
    WdfCmResourceListRemove(
                            ResourcesTranslated,
                            2
                            );
...

}

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 da DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Confira também

WdfCmResourceListRemoveByDescriptor