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 |
---|---|
|
Un parametro di input non è valido. |
|
Nessun dispositivo corrisponde alla descrizione di identificazione specificata. |
|
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