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 de retorno | Descripción |
|---|---|
|
El identificador de dispositivo no representa un PDO. |
|
El identificador dispositivo no representa un dispositivo que se enumerado dinámicamente. |
El método también puede devolver otros valores de NTSTATUS.
Se produce una comprobación de errores del sistema si el controlador proporciona un identificador de objeto no válido.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| encabezado | wdfpdo.h (incluya Wdf.h) |
| Biblioteca | 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