Función WdfPdoRetrieveAddressDescription (wdfpdo.h)
[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 |
|---|---|
|
El identificador de dispositivo no representa un PDO. |
|
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