struttura WDF_CHILD_RETRIEVE_INFO (wdfchildlist.h)
[Si applica solo a KMDF]
La struttura WDF_CHILD_RETRIEVE_INFO contiene informazioni su un dispositivo figlio ottenuto chiamando WdfChildListRetrieveNextDevice o WdfChildListRetrievePdo.
Sintassi
typedef struct _WDF_CHILD_RETRIEVE_INFO {
ULONG Size;
PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription;
PWDF_CHILD_ADDRESS_DESCRIPTION_HEADER AddressDescription;
WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS Status;
PFN_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_COMPARE EvtChildListIdentificationDescriptionCompare;
} WDF_CHILD_RETRIEVE_INFO, *PWDF_CHILD_RETRIEVE_INFO;
Members
Size
Dimensione, in byte, della struttura.
IdentificationDescription
Puntatore a una struttura di WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER allocata dal driver. Il driver deve fornire un valore per il membro IdentificationDescriptionSize di questa struttura.
Se il driver chiama WdfChildListRetrieveNextDevice e fornisce una funzione di callback EvtChildListIdentificationDescriptionCompare , il driver deve anche fornire una descrizione di identificazione che la funzione di callback può usare per confrontare con una voce in un elenco figlio.
Se il driver chiama WdfChildListRetrievePdo, il driver deve compilare l'intera descrizione dell'identificazione.
AddressDescription
Puntatore a una struttura di WDF_CHILD_ADDRESS_DESCRIPTION_HEADER allocata dal driver. Il driver deve fornire un valore per il membro AddressDescriptionSize di questa struttura. Il framework compila il resto della descrizione dell'indirizzo quando recupera un elemento figlio dall'elenco figlio. Se il valore di AddressDescriptionSize è NULL, le informazioni sulla descrizione dell'indirizzo non vengono recuperate.
Status
Valore tipizzato WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS fornito dal framework.
EvtChildListIdentificationDescriptionCompare
Puntatore fornito dal driver a una funzione di callback EvtChildListIdentificationDescriptionCompare .
Se il driver chiama WdfChildListRetrieveNextDevice, questo puntatore è facoltativo e può essere NULL.
Se il driver chiama WdfChildListRetrievePdo, questo puntatore non viene usato.
Commenti
La struttura WDF_CHILD_RETRIEVE_INFO viene passata ai metodi WdfChildListRetrieveNextDevice e WdfChildListRetrievePdo .
Per inizializzare una struttura di WDF_CHILD_RETRIEVE_INFO, il driver deve chiamare WDF_CHILD_RETRIEVE_INFO_INIT.
Requisiti
| Requisito | Valore |
|---|---|
| Versione KMDF minima | 1.0 |
| Intestazione | wdfchildlist.h (include Wdf.h) |
Vedi anche
EvtChildListIdentificationDescriptionCompare
WDF_CHILD_ADDRESS_DESCRIPTION_HEADER
WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER
WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS