Funzione SetupDiGetActualModelsSectionA (setupapi.h)
La funzione SetupDiGetActualModelsSection recupera la sezione MODELLI INF decorata appropriata da usare durante l'installazione di un dispositivo da un file INF del dispositivo.
Sintassi
WINSETUPAPI BOOL SetupDiGetActualModelsSectionA(
[in] PINFCONTEXT Context,
[in, optional] PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
[out, optional] PSTR InfSectionWithExt,
[in] DWORD InfSectionWithExtSize,
[out, optional] PDWORD RequiredSize,
PVOID Reserved
);
Parametri
[in] Context
Puntatore a un contesto di file INF che specifica una voce identificatore produttore in una sezione INF Manufacturer di un file INF. La voce identificatore produttore specifica un nome della sezione MODELLI INF e specifica facoltativamente le decorazioni TargetOSVersion per il nome della sezione Modelli . Per informazioni sui file INF e su un contesto di file INF, vedere gli argomenti di Platform SDK sull'uso di file INF e sulla struttura INFCONTEXT.
[in, optional] AlternatePlatformInfo
Puntatore a una struttura SP_ALTPLATFORM_INFO che fornisce informazioni su una versione e un'architettura del processore di Windows. Il membro cbSize di questa struttura deve essere impostato su sizeof(SP_ALTPLATFORM_INFO_V2). Questo parametro è facoltativo e può essere impostato su NULL.
[out, optional] InfSectionWithExt
Puntatore a un buffer che riceve una stringa contenente il nome della sezione MODELLI INF decorati e un terminatore NULL. Se AlternatePlatformInfo non viene fornito, il nome della sezione MODELLI INF decorati si applica alla piattaforma corrente; in caso contrario, il nome si applica alla piattaforma alternativa specificata. Questo parametro è facoltativo e può essere impostato su NULL. Se questo parametro è NULL, la funzione restituisce TRUE e imposta RequiredSize sulle dimensioni, in caratteri, necessaria per restituire il nome della sezione Modelli decorati e un carattere NULL terminante.
[in] InfSectionWithExtSize
Dimensioni, in caratteri, del buffer DecoratedModelsSection . Se DecoratedModelsSection è NULL, questo parametro deve essere impostato su zero.
[out, optional] RequiredSize
Puntatore a una variabile di tipo DWORD che riceve le dimensioni, in caratteri, del buffer DecoratedModelsSection necessario per recuperare il nome della sezione Modelli decorati e un carattere NULL terminante. Questo parametro è facoltativo e può essere impostato su NULL.
Reserved
Riservato per l'uso interno del sistema. Questo parametro deve essere impostato su NULL.
Valore restituito
SetupDiGetActualModelsSection restituisceTRUE se l'operazione ha esito positivo. In caso contrario, la funzione restituisce FALSE e l'errore registrato può essere recuperato con una chiamata a GetLastError.
Commenti
SetupDiGetActualModelsSection determina quali campi TargetOSVersion nella voce identificatore produttore (fornito da Context) si applicano alla piattaforma corrente, se AlternatePlatformInfo non viene fornito o a una piattaforma alternativa, se vengono fornite informazioni sulla piattaforma alternativa. SetupDiGetActualModelsSection seleziona la piattaforma più appropriata in base a tutti i campi TargetOSVersion, aggiunge la stringa TargetOSVersion al nome della sezione ModelliINF e restituisce il nome della sezione MODELLI INF decorati al chiamante. In una voce di identificatore produttore , la versione principale del sistema operativo viene specificata dal campo OSMajorVersion e la versione secondaria del sistema operativo viene specificata dal campo OSMinorVersion .
Per informazioni sul recupero di una sezione DDInstall INF per un dispositivo, vedere SetupDiGetActualSectionToInstall.
Nota
L'intestazione setupapi.h definisce SetupDiGetActualModelsSection come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Client minimo supportato | Disponibile in Windows Server 2003 con Service Pack 1 (SP1) e versioni successive di Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | setupapi.h (includere Setupapi.h) |
| Libreria | Setupapi.lib |