Función WdfCmResourceListRemove (wdfresource.h)

  • Artículo

[Solo se aplica a KMDF]

El método WdfCmResourceListRemove quita un descriptor de recursos de una lista de recursos especificada.

Sintaxis

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

Parámetros

[in] List

Identificador de un objeto de lista de recursos de marco que representa una lista de recursos de hardware para un dispositivo.

[in] Index

Valor de base cero que se usa como índice en la lista de recursos que especifica List .

Valor devuelto

None

Observaciones

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

El método WdfCmResourceListRemove quita el descriptor de recursos asociado al valor de índice que especifica el parámetro Index .

Cuando WdfCmResourceListRemove quita el descriptor de recursos que tiene el valor de índice n, el valor de índice del siguiente descriptor de recursos cambia de n+1 a n.

Para obtener más información sobre las listas de recursos, consulte Recursos de hardware para controladores de Framework-Based.

Ejemplos

En el ejemplo de código siguiente se quita el tercer descriptor de recursos de las listas sin procesar y traducidas de recursos de hardware que recibe una función de devolución de llamada EvtDeviceRemoveAddedResources .

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

}

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Encabezado wdfresource.h (incluya Wdf.h)
Library Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos).
IRQL <=DISPATCH_LEVEL
Reglas de cumplimiento de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte también

WdfCmResourceListRemoveByDescriptor