Funzione WdfPdoUpdateAddressDescription (wdfpdo.h)

  • Articolo

[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 di un dispositivo (PDO).

[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 dispositivo non rappresenta un oggetto PDO.
STATUS_INVALID_DEVICE_REQUEST
 L'handle dispositivo non rappresenta un dispositivo enumerato in modo dinamico oppure se il membro Size della struttura di WDF_CHILD_ADDRESS_DESCRIPTION_HEADER specificata non corrisponde alle dimensioni della descrizione dell'indirizzo esistente del dispositivo.
 

Il metodo potrebbe restituire anche altri valori NTSTATUS.

Un controllo del bug di sistema si verifica se il driver fornisce un handle di oggetti non valido.

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Intestazione wdfpdo.h (includere Wdf.h)
Libreria Wdf01000.sys (vedere Framework Library Versioning).
IRQL <= DISPATCH_LEVEL
Regole di conformità DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

WdfPdoRetrieveAddressDescription