Função WdfCmResourceListRemove (wdfresource.h)

[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 da estrutura que representa uma lista de recursos de hardware para um dispositivo.

[in] Index

Um valor baseado em zero usado como um índice na lista de recursos que lista especifica.

Valor de retorno

Nenhum

Observações

Uma verificação de bug ocorre se o driver fornece 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 recursos 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 um EvtDeviceRemoveAddedResources função de retorno de chamada recebe.

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

}

Requisitos

Consulte também

WdfCmResourceListRemoveByDescriptor