WDF_CHILD_RETRIEVE_INFO-Struktur (wdfchildlist.h)
[Gilt nur für KMDF]
Die WDF_CHILD_RETRIEVE_INFO-Struktur enthält Informationen zu einem untergeordneten Gerät, das durch Aufrufen von WdfChildListRetrieveNextDevice oder WdfChildListRetrievePdo abgerufen wird.
Syntax
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;
Member
Size
Die Größe (in Bytes) dieser Struktur.
IdentificationDescription
Ein Zeiger auf eine vom Treiber zugewiesene WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER-Struktur . Der Treiber muss einen Wert für den IdentificationDescriptionSize-Member dieser Struktur angeben.
Wenn der Treiber WdfChildListRetrieveNextDeviceaufruft und eine EvtChildListIdentificationDescriptionCompare-Rückruffunktion bereitstellt, muss der Treiber auch eine Identifikationsbeschreibung angeben, die die Rückruffunktion verwenden kann, um mit einem Eintrag in einer untergeordneten Liste zu vergleichen.
Wenn der Treiber WdfChildListRetrievePdo aufruft, muss der Treiber die gesamte Identifikationsbeschreibung ausfüllen.
AddressDescription
Ein Zeiger auf eine vom Treiber zugewiesene WDF_CHILD_ADDRESS_DESCRIPTION_HEADER-Struktur . Der Treiber muss einen Wert für den AddressDescriptionSize-Member dieser Struktur angeben. Das Framework füllt den Rest der Adressbeschreibung aus, wenn es ein untergeordnetes Element aus der untergeordneten Liste abruft. Wenn der Wert von AddressDescriptionSizeNULL ist, werden keine Adressbeschreibungsinformationen abgerufen.
Status
Ein WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS typisierter Wert, den das Framework bereitstellt.
EvtChildListIdentificationDescriptionCompare
Ein vom Treiber bereitgestellter Zeiger auf eine EvtChildListIdentificationDescriptionCompare-Rückruffunktion .
Wenn der Treiber WdfChildListRetrieveNextDevice aufruft, ist dieser Zeiger optional und kann NULL sein.
Wenn der Treiber WdfChildListRetrievePdo aufruft, wird dieser Zeiger nicht verwendet.
Hinweise
Die WDF_CHILD_RETRIEVE_INFO-Struktur wird an die Methoden WdfChildListRetrieveNextDevice und WdfChildListRetrievePdo übergeben.
Um eine WDF_CHILD_RETRIEVE_INFO-Struktur zu initialisieren, muss der Treiber WDF_CHILD_RETRIEVE_INFO_INIT aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| KMDF-Mindestversion | 1.0 |
| Kopfzeile | wdfchildlist.h (include Wdf.h) |
Weitere Informationen
EvtChildListIdentificationDescriptionCompare
WDF_CHILD_ADDRESS_DESCRIPTION_HEADER
WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER
WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS