struttura WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER (wdfchildlist.h)
[Si applica solo a KMDF]
La struttura WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER è una struttura di intestazione che deve essere il primo membro di ogni struttura di descrizione di 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 struttura di 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 struttura WDF_CHILD_LIST_CONFIG .
Le strutture di descrizione dell'identificazione sono definite dal driver. Il driver deve archiviare le dimensioni della struttura nel membro IdentificationDescriptionSize . Il valore della dimensione deve includere le dimensioni di questa struttura di intestazione. Ad esempio, un driver può definire un descrittore di identificazione come indicato di seguito:
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 indirizzo, 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
Requisito | Valore |
---|---|
Versione KMDF minima | 1.0 |
Intestazione | wdfchildlist.h (include Wdf.h) |
Vedi anche
WDF_CHILD_ADDRESS_DESCRIPTION_HEADER