Função WdfIoResourceListCreate (wdfresource.h)
[Aplica-se somente ao KMDF]
O método WdfIoResourceListCreate cria uma configuração lógica vazia, que pode ser preenchida e adicionada a uma lista de requisitos de recursos.
Sintaxe
NTSTATUS WdfIoResourceListCreate(
[in] WDFIORESREQLIST RequirementsList,
[in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
[out] WDFIORESLIST *ResourceList
);
Parâmetros
[in] RequirementsList
Um identificador para um objeto de lista de requisitos de recursos da estrutura que representa a lista de requisitos de recursos de um dispositivo.
[in, optional] Attributes
Um ponteiro para uma estrutura de WDF_OBJECT_ATTRIBUTES alocada pelo chamador que contém atributos para o novo objeto. (O membro ParentObject da estrutura deve ser NULL .) Esse parâmetro é opcional e pode ser WDF_NO_OBJECT_ATTRIBUTES.
[out] ResourceList
Um identificador para um objeto de lista de intervalo de recursos da estrutura que representa a nova configuração lógica.
Valor de retorno
WdfIoResourceListCreate retornará STATUS_SUCCESS se a operação for bem-sucedida.
Para obter valores retornados adicionais, consulte Erros de Criação de Objeto da Estrutura.
Uma verificação de bugs do sistema ocorre se o driver fornece um identificador de objeto inválido.
Observações
Para obter mais informações sobre listas de requisitos de recursos e configurações lógicas, consulte Recursos de Hardware para drivers de Framework-Based.
O objeto resource-requirements-list especificado pelo chamador torna-se o pai do novo objeto resource-range-list. O driver não pode alterar esse pai e o membro ParentObject ou a estrutura WDF_OBJECT_ATTRIBUTES deve ser NULL.
Exemplos
Para obter um exemplo de código que usa WdfIoResourceListCreate, consulte WdfIoResourceRequirementsListAppendIoResList.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| versão mínima do KMDF | 1.0 |
| cabeçalho | wdfresource.h (inclua Wdf.h) |
| biblioteca | Wdf01000.sys (consulte o Controle de Versão da Biblioteca da Estrutura.) |
| IRQL | <=DISPATCH_LEVEL |
| regras de conformidade de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |