estrutura WDF_CHILD_RETRIEVE_INFO (wdfchildlist.h)

  • Artigo

[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

WdfChildListRetrieveNextDevice

WdfChildListRetrievePdo