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.

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

Consulte también

EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS

UrsDeviceInitialize