Funzione SetupDiGetActualModelsSectionA (setupapi.h)

Articolo
08/26/2023

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

Vedi anche

Sezione INF DDInstall

SP_ALTPLATFORM_INFO

SetupDiGetActualSectionToInstall

Condividi tramite