Funzione WdfChildListRetrieveAddressDescription (wdfchildlist.h)

Articolo
08/08/2023

[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

Condividi tramite