estrutura WDF_CHILD_RETRIEVE_INFO (wdfchildlist.h)
[Aplica-se somente ao KMDF]
A estrutura WDF_CHILD_RETRIEVE_INFO contém informações sobre um dispositivo filho obtido chamando WdfChildListRetrieveNextDevice ou WdfChildListRetrievePdo.
Sintaxe
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;
Membros
Size
O tamanho, em bytes, dessa estrutura.
IdentificationDescription
Um ponteiro para uma estrutura de WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER alocada por driver. O driver deve fornecer um valor para o membro IdentificationDescriptionSize dessa estrutura.
Se o driver estiver chamando WdfChildListRetrieveNextDevice e fornecendo uma função de retorno de chamada EvtChildListIdentificationDescriptionCompare , o driver também deverá fornecer uma descrição de identificação que a função de retorno de chamada pode usar para comparar com uma entrada em uma lista filho.
Se o driver estiver chamando WdfChildListRetrievePdo, o driver deverá preencher toda a descrição de identificação.
AddressDescription
Um ponteiro para uma estrutura de WDF_CHILD_ADDRESS_DESCRIPTION_HEADER alocada por driver. O driver deve fornecer um valor para o membro AddressDescriptionSize dessa estrutura. A estrutura preenche o restante da descrição do endereço quando recupera um filho da lista filho. Se o valor de AddressDescriptionSize for NULL, as informações de descrição do endereço não serão recuperadas.
Status
Um valor de tipo WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS que a estrutura fornece.
EvtChildListIdentificationDescriptionCompare
Um ponteiro fornecido pelo driver para uma função de retorno de chamada EvtChildListIdentificationDescriptionCompare .
Se o driver estiver chamando WdfChildListRetrieveNextDevice, esse ponteiro será opcional e poderá ser NULL.
Se o driver estiver chamando WdfChildListRetrievePdo, esse ponteiro não será usado.
Comentários
A estrutura WDF_CHILD_RETRIEVE_INFO é passada para os métodos WdfChildListRetrieveNextDevice e WdfChildListRetrievePdo .
Para inicializar uma estrutura de WDF_CHILD_RETRIEVE_INFO, o driver deve chamar WDF_CHILD_RETRIEVE_INFO_INIT.
Requisitos
| Requisito | Valor |
|---|---|
| Versão mínima do KMDF | 1.0 |
| Cabeçalho | wdfchildlist.h (inclua Wdf.h) |
Confira também
EvtChildListIdentificationDescriptionCompare
WDF_CHILD_ADDRESS_DESCRIPTION_HEADER
WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER
WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS