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 a função de host ou função.
Sintaxe
NTSTATUS UrsIoResourceListAppendDescriptor(
[in] URSIORESLIST IoResourceList,
[in] PIO_RESOURCE_DESCRIPTOR Descriptor
);
Parâmetros
[in] IoResourceList
Um 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 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.
Valor de retorno
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.
Observações
Depois que o driver 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 do driver cliente de EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS, ela passa um identificador WDFIORESREQLIST para essa lista de requisitos, juntamente com identificadores URSIORESLIST para host e função de função listas de recursos. Na implementação, espera-se que o driver cliente enumere por meio da lista de requisitos e adicione o descritor de recursos (se ele quiser usar esse recurso) à lista de recursos para cada função.
Para adicionar um descritor de recurso 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 Tratamento de recursos de hardware.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 10 |
| servidor com suporte mínimo | Windows Server 2016 |
| da 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 |