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 WdfChildListRetrievePdoabgerufen 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;
Angehörige
Size
Die Größe dieser Struktur in Byte.
IdentificationDescription
Ein Zeiger auf eine vom Treiber zugewiesene WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER Struktur. Der Treiber muss einen Wert für die IdentificationDescriptionSize Member dieser Struktur angeben.
Wenn der Treiber WdfChildListRetrieveNextDevice aufruft und eine EvtChildListIdentificationDescriptionCompare Rückruffunktion bereitstellt, muss der Treiber auch eine Identifikationsbeschreibung bereitstellen, die Rückruffunktion zum Vergleichen mit einem Eintrag in einer untergeordneten Liste verwenden kann.
Wenn der Treiber WdfChildListRetrievePdoaufruft, 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 das 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-typed-Wert, den das Framework bereitstellt.
EvtChildListIdentificationDescriptionCompare
Ein vom Treiber bereitgestellter Zeiger auf eine EvtChildListIdentificationDescriptionCompare Rückruffunktion.
Wenn der Treiber WdfChildListRetrieveNextDeviceaufruft, ist dieser Zeiger optional und kann NULL-sein.
Wenn der Treiber WdfChildListRetrievePdoaufruft, wird dieser Zeiger nicht verwendet.
Bemerkungen
Die WDF_CHILD_RETRIEVE_INFO Struktur wird an die WdfChildListRetrieveNextDevice und WdfChildListRetrievePdo Methoden übergeben.
Um eine WDF_CHILD_RETRIEVE_INFO-Struktur zu initialisieren, muss der Treiber WDF_CHILD_RETRIEVE_INFO_INITaufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Minimale KMDF-Version | 1.0 |
| Header- | wdfchildlist.h (include Wdf.h) |
Siehe auch
EvtChildListIdentificationDescriptionCompare
WDF_CHILD_ADDRESS_DESCRIPTION_HEADER
WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER
WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS