Função WdfPdoUpdateAddressDescription (wdfpdo.h)
[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 de WDF_CHILD_ADDRESS_DESCRIPTION_HEADER .
Retornar valor
Se a operação for bem-sucedida, a função retornará STATUS_SUCCESS. Os valores retornados adicionais incluem:
| Código de retorno | Descrição |
|---|---|
|
O identificador de dispositivo não representa um PDO. |
|
O identificador de dispositivo não representa um dispositivo que foi enumerado dinamicamente ou se o membro Size da estrutura de WDF_CHILD_ADDRESS_DESCRIPTION_HEADER especificada não corresponder ao tamanho da descrição do endereço existente do dispositivo. |
O método também pode retornar outros valores NTSTATUS.
Um bug do sistema marcar ocorrerá se o driver fornecer um identificador de objeto inválido.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Versão mínima do KMDF | 1.0 |
| Cabeçalho | wdfpdo.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) |