Função WdfPdoRetrieveAddressDescription (wdfpdo.h)
[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 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:
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
WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT