Função WdfPdoRetrieveAddressDescription (wdfpdo.h)

  • Artigo

[Aplica-se somente ao KMDF]

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

Sintaxe

NTSTATUS WdfPdoRetrieveAddressDescription(
  [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) do dispositivo.

[in, out] AddressDescription

Um ponteiro para um buffer alocado pelo chamador que receberá a descrição do 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
STATUS_INVALID_PARAMETER
 O identificador de dispositivo não representa um PDO.
STATUS_INVALID_DEVICE_REQUEST
 O identificador do dispositivo não representa um dispositivo que foi enumerado dinamicamente.
 

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)

Confira também

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT

WdfChildListRetrieveAddressDescription

WdfPdoRetrieveIdentificationDescription