Função WdfIoResourceListCreate (wdfresource.h)

  • Artigo

[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 framework resource-requirements-list 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 framework resource-range-list que representa a nova configuração lógica.

Retornar valor

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.

Um bug do sistema marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Comentários

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 devem ser NULL.

Exemplos

Para obter um exemplo de código que usa WdfIoResourceListCreate, consulte WdfIoResourceRequirementsListAppendIoResList.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Cabeçalho wdfresource.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.)
IRQL <=DISPATCH_LEVEL
Regras de conformidade de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Confira também

WDF_OBJECT_ATTRIBUTES