Funzione WdfChildListRetrieveAddressDescription (wdfchildlist.h)

Articolo
02/07/2025

[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 WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER allocata dal chiamante che identifica una descrizione di 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(status) è uguale a TRUE, se l'operazione ha esito positivo. In caso contrario, questo metodo potrebbe restituire uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_INVALID_PARAMETER	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 le dimensioni della descrizione dell'indirizzo che AddressDescription specificato non è corretta.

Questo metodo può anche restituire altri valori NTSTATUS .

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

Osservazioni

Per altre informazioni sugli elenchi figlio, vedere 'enumerazione dinamica.

Esempi

Nell'esempio di codice seguente viene eseguita una ricerca in un elenco figlio di 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;
}

Fabbisogno

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

Vedere 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