Funzione WdfChildListRetrieveAddressDescription (wdfchildlist.h)

[Si applica solo a KMDF]

Il metodo WdfChildListRetrieveAddressDescription individua un dispositivo figlio con una descrizione di identificazione specificata e recupera la descrizione dell'indirizzo del dispositivo.

Sintassi

NTSTATUS WdfChildListRetrieveAddressDescription(
  [in]      WDFCHILDLIST                                 ChildList,
  [in]      PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription,
  [in, out] PWDF_CHILD_ADDRESS_DESCRIPTION_HEADER        AddressDescription
);

Parametri

[in] ChildList

Handle per un oggetto elenco figlio.

[in] IdentificationDescription

Puntatore a una struttura di WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER allocata dal chiamante che identifica una descrizione dell'identificazione figlio fornita dal driver.

[in, out] AddressDescription

Puntatore a una struttura WDF_CHILD_ADDRESS_DESCRIPTION_HEADER che identifica una descrizione dell'indirizzo figlio. Il framework compila questa descrizione.

Valore restituito

WdfChildListRetrieveAddressDescription restituisce STATUS_SUCCESS o un altro valore di stato per cui NT_SUCCESS(stato) è TRUE, se l'operazione ha esito positivo. In caso contrario, questo metodo potrebbe restituire uno dei valori seguenti:

Codice restituito Descrizione
STATUS_INVALID_PARAMETER
Un parametro di input non è valido.
STATUS_NO_SUCH_DEVICE
Nessun dispositivo corrisponde alla descrizione di identificazione specificata.
STATUS_INVALID_DEVICE_REQUEST
L'elenco figlio non contiene descrizioni degli indirizzi o la dimensione della descrizione dell'indirizzo specificata non è corretta.
 

Questo 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.

Commenti

Per altre informazioni sugli elenchi figlio, vedere Enumerazione dinamica.

Esempio

L'esempio di codice seguente cerca un elenco figlio per un dispositivo figlio la cui descrizione di identificazione contiene il valore specificato da SomeValue. Se WdfChildListRetrieveAddressDescription individua il dispositivo, recupera la descrizione dell'indirizzo del dispositivo.

MY_IDENTIFICATION_DESCRIPTION  id;
MY_ADDRESS_DESCRIPTION  addrDescrip;

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT(
                                                 &id.Header,
                                                 sizeof(id)
                                                 );
WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT(
                                          &addrDescrip.Header,
                                          sizeof(addrDescrip)
                                          );

id.DeviceIdentifier = SomeValue;
status = WdfChildListRetrieveAddressDescription(
                                                list,
                                                &idDescrip.Header,
                                                &addrDescrip.Header
                                                );
if (!NT_SUCCESS(status) {
    return status;
}

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Intestazione wdfchildlist.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

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT