estrutura WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER (wdfchildlist.h)

  • Artigo

[Aplica-se somente ao KMDF]

A estrutura WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER é uma estrutura de cabeçalho que deve ser o primeiro membro de cada estrutura de descrição de identificação .

Sintaxe

typedef struct _WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER {
  ULONG IdentificationDescriptionSize;
} WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER, *PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER;

Membros

IdentificationDescriptionSize

O tamanho, em bytes, de uma estrutura definida pelo driver que contém informações de identificação do dispositivo.

Comentários

Para inicializar uma estrutura de WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER , o driver deve chamar WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT.

O valor que o driver especifica para o membro IdentificationDescriptionSize deve corresponder ao valor especificado para o membro IdentificationDescriptionSize em sua estrutura WDF_CHILD_LIST_CONFIG .

As estruturas de descrição de identificação são definidas pelo driver. O driver deve armazenar o tamanho da estrutura no membro IdentificationDescriptionSize . O valor de tamanho deve incluir o tamanho dessa estrutura de cabeçalho. Por exemplo, um driver pode definir um descritor de identificação da seguinte maneira:

typedef struct _IEEE_1394_CHILD_ID_DESCRIPTION {
  WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER  IdHeader;
 WCHAR  VendorName[32];
 WCHAR  ModelName[32];
 LONG  UnitSpecId; 
 LONG  UnitSoftwareVersion;
} IEEE_1394_CHILD_ID_DESCRIPTION, *PIEEE_1394_CHILD_ID_DESCRIPTION;

Para definir o membro IdentificationDescriptionSize para esse descritor de endereço, o driver pode usar o seguinte código:

IEEE_1394_CHILD_ID_DESCRIPTION ID_Description;
WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT(&ID_Description,
                                                 sizeof(ID_Description));

Para obter mais informações sobre descrições de identificação, consulte Enumeração dinâmica.

Requisitos

Requisito Valor
Versão mínima do KMDF 1.0
Cabeçalho wdfchildlist.h (inclua Wdf.h)

Confira também

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WDF_CHILD_LIST_CONFIG