Función WdfCmResourceListRemove (wdfresource.h)
[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) |