Condividi tramite

Definizione ed esportazione di nuovi GUID

  • Articolo

Si definisce un nuovo GUID per un elemento che il driver esporta in altri componenti di sistema, driver o applicazioni. Ad esempio, si definisce un nuovo GUID per un evento PnP personalizzato in uno dei dispositivi. Per definire ed esportare un nuovo GUID, è necessario eseguire le operazioni seguenti:

  1. Scegliere un nome simbolico per il GUID.

    Scegliere un nome che rappresenta lo scopo del GUID. Ad esempio, il sistema operativo usa nomi come GUID_BUS_TYPE_PCI e PARPORT_WMI_ALLOCATE_FREE_COUNTS_GUID.

  2. Generare un valore per il GUID usando Uuidgen.exe o Guidgen.exe. Quando si installa il Microsoft Windows SDK, Uuidgen.exe viene installato automaticamente.

    Queste utilità generano una stringa univoca formattata che rappresenta un valore a 128 bit. L'opzione "-s" su Uuidgen.exe restituisce il GUID formattato come struttura C.

  3. Definire il GUID in un file di intestazione appropriato.

    Usare la macro DEFINE_GUID (definita in Guiddef.h) per associare il nome simbolico GUID al relativo valore (vedere l'esempio 1).

    Esempio 1: Definizione di GUID in un file di intestazione GUID-Only

    :

DEFINE_GUID( GUID_BUS_TYPE_PCMCIA, 0x09343630L, 0xaf9f, 0x11d0, 
    0x92,0x9f, 0x00, 0xc0, 0x4f, 0xc3, 0x40, 0xb1 );
DEFINE_GUID( GUID_BUS_TYPE_PCI, 0xc8ebdfb0L, 0xb510, 0x11d0, 
    0x80,0xE9, 0x00, 0x00, 0xf8, 0x1e, 0x1b, 0x30 );

:

    Se il GUID è definito in un file di intestazione che contiene istruzioni diverse dalle definizioni GUID, è necessario eseguire un passaggio aggiuntivo per assicurarsi che il GUID venga creato un'istanza nei driver che includono il file di intestazione. L'istruzione DEFINE_GUID deve essere eseguita all'esterno di qualsiasi istruzione #ifdef che impedisca l'inclusione multipla. In caso contrario, se il file di intestazione è incluso in un'intestazione precompilata, il GUID non verrà creata un'istanza nei driver che usano il file di intestazione. Vedere l'esempio 2 per una definizione GUID di esempio in un file di intestazione mista.

    Esempio 2: Definizione di GUID in un file di intestazione mista

    #ifndef _NTDDSER_    // this ex. is from a serial driver .h file
#define _NTDDSER_

:
// Put other header file definitions here.
:

#endif  // _NTDDSER_

#ifdef DEFINE_GUID   // Do not break compiles of drivers that 
                     // include this header but that do not
                     // want the GUIDs.
//
// Put GUID definitions outside of the multiple inclusion 
// protection.

DEFINE_GUID(GUID_CLASS_COMPORT, 0x86e0d1e0L, 0x8089, 0x11d0, 0x9c,
    0xe4, 0x08, 0x00, 0x3e, 0x30, 0x1f, 0x73);

DEFINE_GUID (GUID_SERENUM_BUS_ENUMERATOR, 0x4D36E978, 0xE325, 
    0x11CE, 0xBF, 0xC1, 0x08, 0x00, 0x2B, 0xE1, 0x03, 0x18);

:
#endif  // DEFINE_GUID

    L'inserimento di una definizione GUID all'esterno di istruzioni che impediscono l'inclusione multipla non causa più istanze del GUID in un driver perché DEFINE_GUID definisce il GUID come variabile EXTERN_C. Sono consentite più dichiarazioni di una variabile EXTERN purché i tipi corrispondano.

  4. Quando si crea un GUID per una nuova classe di configurazione del dispositivo o una classe dell'interfaccia del dispositivo, si applicano le regole seguenti:

    • Non usare un singolo GUID per identificare sia una classe di installazione del dispositivo che una classe di interfaccia del dispositivo.

    • Quando si crea un nome simbolico da associare al GUID, usare la convenzione seguente:

      Per le classi di installazione del dispositivo, usare il formato GUID_DEVCLASS_XXX.

      Per le classi dell'interfaccia del dispositivo, usare il formato GUID_DEVINTERFACE_XXX.