Funzione SetupDiGetActualModelsSectionW (setupapi.h)

Articolo
08/26/2023

La funzione SetupDiGetActualModelsSection recupera la sezione appropriata dei modelli INF decorati da usare durante l'installazione di un dispositivo da un file INF del dispositivo.

Sintassi

WINSETUPAPI BOOL SetupDiGetActualModelsSectionW(
  [in]            PINFCONTEXT          Context,
  [in, optional]  PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
  [out, optional] PWSTR                InfSectionWithExt,
  [in]            DWORD                InfSectionWithExtSize,
  [out, optional] PDWORD               RequiredSize,
                  PVOID                Reserved
);

Parametri

[in] Context

Puntatore a un contesto di file INF che specifica una voce di identificatore produttore in una sezione INF Manufacturer di un file INF. La voce manufacturer-identifier specifica un nome di sezione INF Models e, facoltativamente, specifica le decorazioni TargetOSVersion per il nome della sezione Models . Per informazioni sui file INF e su un contesto di file INF, vedere gli argomenti di Platform SDK sull'uso dei file INF e della struttura INFCONTEXT.

[in, optional] AlternatePlatformInfo

Puntatore a una struttura SP_ALTPLATFORM_INFO che fornisce informazioni su una versione di Windows e un'architettura del processore. 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 carattere di terminazione 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, necessari per restituire il nome della sezione Modelli decorati e un carattere NULL di terminazione.

[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 di terminazione. 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 dell'identificatore del produttore (fornito da Context) si applicano alla piattaforma corrente, se AlternatePlatformInfo non viene fornito o a una piattaforma alternativa, se vengono fornite informazioni alternative sulla piattaforma. SetupDiGetActualModelsSection seleziona la piattaforma più appropriata in base a tutti i campi TargetOSVersion , aggiunge la stringa TargetOSVersion al nome della sezione MODELLI INF e restituisce il nome della sezione Modelli INF decorati al chiamante. In una voce dell'identificatore del 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 INF DDInstall 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
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 (include Setupapi.h)
Libreria	Setupapi.lib

Vedi anche

Sezione INF DDInstall

SP_ALTPLATFORM_INFO

SetupDiGetActualSectionToInstall

Condividi tramite