Função WdfIoResourceListUpdateDescriptor (wdfresource.h)

[Aplica-se somente ao KMDF]

O método WdfIoResourceListUpdateDescriptor atualiza um descritor de recursos no de configuração lógica de uma lista de requisitos de recursos.

Sintaxe

VOID WdfIoResourceListUpdateDescriptor(
  [in] WDFIORESLIST            ResourceList,
  [in] PIO_RESOURCE_DESCRIPTOR Descriptor,
  [in] ULONG                   Index
);

Parâmetros

[in] ResourceList

Um identificador para um objeto de lista de intervalo de recursos da estrutura que representa uma configuração lógica de recursos de hardware para um dispositivo.

[in] Descriptor

Um ponteiro para uma estrutura de IO_RESOURCE_DESCRIPTOR que descreve um recurso de hardware.

[in] Index

Um valor baseado em zero usado como um índice no conjunto de descritores de recursos que já estão na configuração lógica especificada ResourceList.

Valor de retorno

Nenhum

Observações

Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.

O método WdfIoResourceListUpdateDescriptor localiza o descritor de recursos identificado pelo parâmetro Index. Em seguida, o método copia o descritor de recursos especificado pelo descritor de no descritor especificado pelo Index.

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.

Exemplos

O exemplo de código a seguir inicializa um novo descritor de recursos e chama WdfIoResourceListUpdateDescriptor para substituir o segundo descritor em uma configuração lógica pelo novo descritor.

IO_RESOURCE_DESCRIPTOR newDescriptor;

RtlZeroMemory(
              &newDescriptor,
              sizeof(newDescriptor)
              );

newDescriptor.Option = 0;
newDescriptor.Type = CmResourceTypePort;
newDescriptor.ShareDisposition = CmResourceShareDeviceExclusive;
newDescriptor.Flags = CM_RESOURCE_PORT_IO|CM_RESOURCE_PORT_16_BIT_DECODE;
newDescriptor.u.Port.Length = 1;
newDescriptor.u.Port.Alignment = 0x01;
newDescriptor.u.Port.MinimumAddress.QuadPart = 0;
newDescriptor.u.Port.MaximumAddress.QuadPart = 0xFFFF;

WdfIoResourceListUpdateDescriptor(
                                  Reslist,
                                  &newDescriptor,
                                  1
                                  );

Requisitos

Consulte também

IO_RESOURCE_DESCRIPTOR