Função WdfPdoUpdateAddressDescription (wdfpdo.h)

Artigo
03/22/2025

[Aplica-se somente ao KMDF]

O método WdfPdoUpdateAddressDescription atualiza a descrição do endereço associada a um objeto de dispositivo de estrutura especificado.

Sintaxe

NTSTATUS WdfPdoUpdateAddressDescription(
  [in]      WDFDEVICE                             Device,
  [in, out] PWDF_CHILD_ADDRESS_DESCRIPTION_HEADER AddressDescription
);

Parâmetros

[in] Device

Um identificador para um objeto de dispositivo de estrutura que representa o PDO (objeto de dispositivo físico) de um dispositivo.

[in, out] AddressDescription

Um ponteiro para um buffer alocado pelo chamador que contém uma descrição de endereço. A descrição do endereço deve conter uma estrutura WDF_CHILD_ADDRESS_DESCRIPTION_HEADER.

Valor de retorno

Se a operação for bem-sucedida, a função retornará STATUS_SUCCESS. Os valores de retorno adicionais incluem:

Código de retorno	Descrição
STATUS_INVALID_PARAMETER	O identificador do dispositivo não representa um PDO.
STATUS_INVALID_DEVICE_REQUEST	O identificador dispositivo não representa um dispositivo que foi enumerado dinamicamente, ou se o Size membro da estrutura de WDF_CHILD_ADDRESS_DESCRIPTION_HEADER especificada não corresponder ao tamanho da descrição de endereço existente do dispositivo.

O método também pode retornar outros valores NTSTATUS.

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

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
versão mínima do KMDF	1.0
cabeçalho	wdfpdo.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)

Consulte também

WdfPdoRetrieveAddressDescription

Partilhar via