Función WdfPdoRetrieveAddressDescription (wdfpdo.h)

Artículo
03/05/2024

[Solo se aplica a KMDF]

El método WdfPdoRetrieveAddressDescription recupera la descripción de la dirección asociada a un objeto de dispositivo de marco especificado.

Sintaxis

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

Parámetros

[in] Device

Identificador de un objeto de dispositivo de marco que representa el objeto de dispositivo físico (PDO) del dispositivo.

[in, out] AddressDescription

Puntero a un búfer asignado por el autor de la llamada que recibirá la descripción de la dirección. La descripción de la dirección debe contener una estructura WDF_CHILD_ADDRESS_DESCRIPTION_HEADER .

Valor devuelto

Si la operación se realiza correctamente, la función devuelve STATUS_SUCCESS. Entre los valores devueltos adicionales se incluyen:

Código devuelto	Descripción
STATUS_INVALID_PARAMETER	El identificador de dispositivo no representa un PDO.
STATUS_INVALID_DEVICE_REQUEST	El identificador de dispositivo no representa un dispositivo enumerado dinámicamente.

El método también podría devolver otros valores NTSTATUS.

Se produce una comprobación de errores del sistema si el controlador proporciona un identificador de objeto no válido.

Requisitos

Requisito	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1.0
Encabezado	wdfpdo.h (incluya Wdf.h)
Library	Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos).
IRQL	<= DISPATCH_LEVEL
Reglas de cumplimiento de DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte también

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT

WdfChildListRetrieveAddressDescription

WdfPdoRetrieveIdentificationDescription