WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER struttura (wdfchildlist.h)

[Si applica solo a KMDF]

La WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER struttura è una struttura di intestazione che deve essere il primo membro di ogni struttura di descrizione dell'identificazione .

Sintassi

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

Members

IdentificationDescriptionSize

Dimensione, in byte, di una struttura definita dal driver che contiene informazioni di identificazione del dispositivo.

Commenti

Per inizializzare una WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER , il driver deve chiamare WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT.

Il valore specificato dal driver per il membro IdentificationDescriptionSize deve corrispondere al valore specificato per il membro IdentificationDescriptionSize nella relativa WDF_CHILD_LIST_CONFIG proprietà.

Le strutture di descrizione dell'identificazione sono definite dal driver. Il driver deve archiviare le dimensioni della struttura nel membro IdentificationDescriptionSize . Il valore size deve includere le dimensioni di questa struttura di intestazione. Ad esempio, un driver potrebbe definire un descrittore di identificazione come segue:

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;

Per impostare il membro IdentificationDescriptionSize per questo descrittore di indirizzi, il driver può usare il codice seguente:

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

Per altre informazioni sulle descrizioni di identificazione, vedere Enumerazione dinamica.

Requisiti

Versione KMDF minima	1,0
Intestazione	wdfchildlist.h (includere Wdf.h)

Vedi anche

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WDF_CHILD_LIST_CONFIG