Share via

Función UrsIoResourceListAppendDescriptor (ursdevice.h)

  • Artículo

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.

Comentarios

Después de que el controlador cliente llame a UrsDeviceInitialize, el marco asigna memoria para la lista de requisitos de recursos. 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 las listas de recursos de rol de host y función. 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, consulte 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 Value
Cliente mínimo compatible Windows 10
Servidor mínimo compatible Windows Server 2016
Plataforma de destino Windows
Versión mínima de KMDF 1.15
Encabezado ursdevice.h (incluya Urscx.h)
Library Urscxstub.lib
IRQL PASSIVE_LEVEL

Consulte también

EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS

UrsDeviceInitialize