struttura WDF_CHILD_RETRIEVE_INFO (wdfchildlist.h)

  • Articolo

[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

WdfChildListRetrieveNextDevice

WdfChildListRetrievePdo