Funzione WdfPdoRetrieveAddressDescription (wdfpdo.h)

  • Articolo

[Si applica solo a KMDF]

Il metodo WdfPdoRetrieveAddressDescription recupera la descrizione dell'indirizzo associata a un oggetto dispositivo framework specificato.

Sintassi

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

Parametri

[in] Device

Handle a un oggetto dispositivo framework che rappresenta l'oggetto dispositivo fisico del dispositivo (PDO).

[in, out] AddressDescription

Puntatore a un buffer allocato dal chiamante che riceverà la 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.
 

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

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT

WdfChildListRetrieveAddressDescription

WdfPdoRetrieveIdentificationDescription