Función UrsIoResourceListAppendDescriptor (ursdevice.h)
Anexa el descriptor de recursos especificado al objeto de lista de recursos de E/S especificado que mantiene descriptores de recursos para el rol de host o función.
Sintaxis
NTSTATUS UrsIoResourceListAppendDescriptor(
[in] URSIORESLIST IoResourceList,
[in] PIO_RESOURCE_DESCRIPTOR Descriptor
);
Parámetros
[in] IoResourceList
Objeto de lista de recursos de E/S de un rol al que se anexa el descriptor de recursos. El marco asigna este objeto y se pasa al controlador cliente cuando el marco invoca la implementación de EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS del controlador.
[in] Descriptor
Puntero a IO_RESOURCE_DESCRIPTOR que contiene el descriptor de recursos para el rol.
Valor devuelto
El método devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, este método podría devolver un código de error NTSTATUS adecuado.
Observaciones
Después de que el controlador cliente llame a UrsDeviceInitialize, el marco asigna memoria para la lista de requisitos de recursos de . Cuando la extensión de clase de doble rol USB invoca la implementación del controlador cliente de EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS, pasa un identificador WDFIORESREQLIST a esa lista de requisitos junto con los identificadores URSIORESLIST para el rol de host y función listas de recursos. En la implementación, se espera que el controlador de cliente se enumere a través de la lista de requisitos y agregue el descriptor de recursos (si quiere usar ese recurso) a la lista de recursos para cada rol.
Para agregar descriptores de recursos para un rol, el controlador llama a UrsIoResourceListAppendDescriptor y especifica el descriptor y la lista de recursos a la que se debe agregar el recurso.
Para obtener un ejemplo de código, vea EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS.
Para obtener más información sobre las listas de requisitos de recursos, consulte Control de recursos de hardware.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 10 |
| servidor mínimo admitido | Windows Server 2016 |
| de la plataforma de destino de | Windows |
| versión mínima de KMDF | 1.15 |
| encabezado de | ursdevice.h (incluya Urscx.h) |
| biblioteca de | Urscxstub.lib |
| irQL | PASSIVE_LEVEL |