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 descrizione dell'identificazione struttura.
Sintassi
typedef struct _WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER {
ULONG IdentificationDescriptionSize;
} WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER, *PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER;
Membri
IdentificationDescriptionSize
Dimensioni, in byte, di una struttura definita dal driver che contiene informazioni sull'identificazione del dispositivo.
Osservazioni
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 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 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 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.
Fabbisogno
Requisito | Valore |
---|---|
versione minima di KMDF | 1.0 |
intestazione | wdfchildlist.h (include Wdf.h) |
Vedere anche
WDF_CHILD_ADDRESS_DESCRIPTION_HEADER