Funzione WdfPdoUpdateAddressDescription (wdfpdo.h)

Articolo
03/22/2025

[Si applica solo a KMDF]

Il metodo WdfPdoUpdateAddressDescription aggiorna la descrizione dell'indirizzo associata a un oggetto dispositivo framework specificato.

Sintassi

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

Parametri

[in] Device

Handle per un oggetto dispositivo framework che rappresenta l'oggetto dispositivo fisico (PDO) di un dispositivo.

[in, out] AddressDescription

Puntatore a un buffer allocato dal chiamante che contiene una descrizione dell'indirizzo. La descrizione dell'indirizzo deve contenere una struttura WDF_CHILD_ADDRESS_DESCRIPTION_HEADER.

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce STATUS_SUCCESS. I valori restituiti aggiuntivi includono:

Codice restituito	Descrizione
STATUS_INVALID_PARAMETER	L'handle del dispositivo non rappresenta un PDO.
STATUS_INVALID_DEVICE_REQUEST	L'handle device non rappresenta un dispositivo che è stato enumerato dinamicamenteo se il membro dimensioni della struttura di WDF_CHILD_ADDRESS_DESCRIPTION_HEADER specificata non corrisponde alle dimensioni della descrizione dell'indirizzo esistente del dispositivo.

Il metodo potrebbe anche restituire altri valori NTSTATUS.

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo dei bug di sistema.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
versione minima di KMDF	1.0
intestazione	wdfpdo.h (include Wdf.h)
Biblioteca	Wdf01000.sys (vedere Controllo delle versioni della libreria framework).
IRQL	<= LIVELLO_DI_INVIO
regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedere anche

WdfPdoRetrieveAddressDescription

Condividi tramite