Función WdfPdoUpdateAddressDescription (wdfpdo.h)

Artículo
02/27/2024

[Solo se aplica a KMDF]

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

Sintaxis

NTSTATUS WdfPdoUpdateAddressDescription(
  [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) de un dispositivo.

[in, out] AddressDescription

Puntero a un búfer asignado por el autor de la llamada que contiene una descripción de 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, o si el miembro Size de la estructura de WDF_CHILD_ADDRESS_DESCRIPTION_HEADER especificada no coincide con el tamaño de la descripción de la dirección existente del dispositivo.

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

WdfPdoRetrieveAddressDescription