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

WdfChildListRetrieveNextDevice

WdfChildListRetrievePdo