Función WdfIoResourceRequirementsListAppendIoResList (wdfresource.h)
[Solo se aplica a KMDF]
El método WdfIoResourceRequirementsListAppendIoResList agrega una configuración lógica al final de una lista de requisitos de recursos.
Sintaxis
NTSTATUS WdfIoResourceRequirementsListAppendIoResList(
[in] WDFIORESREQLIST RequirementsList,
[in] WDFIORESLIST IoResList
);
Parámetros
[in] RequirementsList
Identificador de un objeto resource-requirements-list de marco que representa la lista de requisitos de recursos de un dispositivo.
[in] IoResList
Identificador de un objeto framework resource-range-list que representa una configuración lógica de recursos de hardware para un dispositivo.
Valor devuelto
WdfIoResourceRequirementsListAppendIoResList devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, este método podría devolver uno de los siguientes valores:
Código devuelto | Descripción |
---|---|
|
Se especificó un parámetro no válido. |
|
El objeto resource-requirements-list especificado no posee el objeto resource-range-list especificado. |
|
El marco no pudo asignar espacio para almacenar el objeto resource-range-list. |
Se produce una comprobación de errores del sistema si el controlador proporciona un identificador de objeto no válido.
Comentarios
Para obtener más información sobre las listas de requisitos de recursos, consulte Recursos de hardware para controladores de Framework-Based.
Ejemplos
En el ejemplo de código siguiente se muestra cómo una función de devolución de llamada EvtDeviceResourceRequirementsQuery crea una configuración lógica vacía y la anexa a una lista de requisitos de recursos.
NTSTATUS
Example_EvtDeviceResourceRequirementsQuery(
IN WDFDEVICE Device,
IN WDFIORESREQLIST RequirementsList
)
{
NTSTATUS status;
WDFIORESLIST logConfig;
status = WdfIoResourceListCreate(
RequirementsList,
WDF_NO_OBJECT_ATTRIBUTES,
&logConfig
);
if (!NT_SUCCESS(status)) {
return status;
}
status = WdfIoResourceRequirementsListAppendIoResList(
RequirementsList,
logConfig
);
if (!NT_SUCCESS(status)) {
return status;
}
...
}
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
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de