Função UrsIoResourceListAppendDescriptor (ursdevice.h)
Acrescenta o descritor de recursos especificado ao objeto de lista de recursos de E/S especificado que mantém descritores de recursos para o host ou função de função.
Sintaxe
NTSTATUS UrsIoResourceListAppendDescriptor(
[in] URSIORESLIST IoResourceList,
[in] PIO_RESOURCE_DESCRIPTOR Descriptor
);
Parâmetros
[in] IoResourceList
O objeto de lista de recursos de E/S de uma função ao qual o descritor de recursos é acrescentado. Esse objeto é alocado pela estrutura e passado para o driver do cliente quando a estrutura invoca a implementação de EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS do driver.
[in] Descriptor
Um ponteiro para IO_RESOURCE_DESCRIPTOR que contém o descritor de recursos para a função.
Retornar valor
O método retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, esse método poderá retornar um código de erro NTSTATUS apropriado.
Comentários
Depois que o driver do cliente chama UrsDeviceInitialize, a estrutura aloca memória para a lista de requisitos de recursos. Quando a extensão de classe de função dupla USB invoca a implementação de EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS do driver cliente, ela passa um identificador WDFIORESREQLIST para essa lista de requisitos, juntamente com identificadores URSIORESLIST para listas de recursos de função e host. Na implementação, espera-se que o driver do cliente enumere por meio da lista de requisitos e adicione o descritor de recursos (se quiser usar esse recurso) à lista de recursos para cada função.
Para adicionar um descritor de recursos para uma função, o driver chama UrsIoResourceListAppendDescriptor e especifica o descritor e a lista de recursos à qual o recurso deve ser adicionado.
Para obter um exemplo de código, consulte EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS.
Para obter mais informações sobre listas de requisitos de recursos, consulte Manipulando recursos de hardware.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 10 |
| Servidor mínimo com suporte | Windows Server 2016 |
| Plataforma de Destino | Windows |
| Versão mínima do KMDF | 1.15 |
| Cabeçalho | ursdevice.h (inclua Urscx.h) |
| Biblioteca | Urscxstub.lib |
| IRQL | PASSIVE_LEVEL |