struttura SP_DEVICE_INTERFACE_DETAIL_DATA_A (setupapi.h)

Articolo
11/20/2024

Una struttura SP_DEVICE_INTERFACE_DETAIL_DATA contiene il percorso di un'interfaccia del dispositivo.

Sintassi

typedef struct _SP_DEVICE_INTERFACE_DETAIL_DATA_A {
  DWORD cbSize;
  CHAR  DevicePath[ANYSIZE_ARRAY];
} SP_DEVICE_INTERFACE_DETAIL_DATA_A, *PSP_DEVICE_INTERFACE_DETAIL_DATA_A;

Membri

cbSize

Dimensione, in byte, della struttura SP_DEVICE_INTERFACE_DETAIL_DATA. Per altre informazioni, vedere la sezione Osservazioni seguente.

DevicePath[ANYSIZE_ARRAY]

Stringa con terminazione NULL che contiene il percorso dell'interfaccia del dispositivo. Questo percorso può essere passato a funzioni Win32, ad esempio CreateFile.

Osservazioni

Una struttura SP_DEVICE_INTERFACE_DETAIL_DATA identifica il percorso di un'interfaccia del dispositivo in un set di informazioni sul dispositivo.

funzioni setupDiXxx che accettano una struttura SP_DEVICE_INTERFACE_DETAIL_DATA come parametro verificare che il membro cbSize della struttura fornita sia uguale alle dimensioni, in byte, della struttura. Se il membro cbSize non è impostato correttamente per un parametro di input, la funzione avrà esito negativo e imposta un codice di errore di ERROR_INVALID_PARAMETER. Se il membro cbSize non è impostato correttamente per un parametro di output, la funzione avrà esito negativo e imposta un codice di errore di ERROR_INVALID_USER_BUFFER.

Nota

L'intestazione setupapi.h definisce SP_DEVICE_INTERFACE_DETAIL_DATA come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
intestazione	setupapi.h (include Setupapi.h)

Vedere anche

SetupDiGetDeviceInterfaceDetail

Condividi tramite