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

Confira também

EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS

UrsDeviceInitialize