Funzione SetupDiGetClassDevPropertySheetsA (setupapi.h)

Articolo
11/20/2024

La funzione SetupDiGetClassDevPropertySheets recupera gli handle nelle finestre delle proprietà di un elemento informazioni dispositivo o della classe di installazione del dispositivo di un set di informazioni sul dispositivo.

Sintassi

WINSETUPAPI BOOL SetupDiGetClassDevPropertySheetsA(
  [in]            HDEVINFO           DeviceInfoSet,
  [in, optional]  PSP_DEVINFO_DATA   DeviceInfoData,
  [in]            LPPROPSHEETHEADERA PropertySheetHeader,
  [in]            DWORD              PropertySheetHeaderPageListSize,
  [out, optional] PDWORD             RequiredSize,
  [in]            DWORD              PropertySheetType
);

Parametri

[in] DeviceInfoSet

Handle per il set di informazioni sul dispositivo per cui restituire handle della finestra delle proprietà. Se DeviceInfoData non specifica un elemento informazioni sul dispositivo nel set di informazioni sul dispositivo, il set di informazioni sul dispositivo deve avere una classe di configurazione del dispositivo associata.

[in, optional] DeviceInfoData

Puntatore a una struttura SP_DEVINFO_DATA che specifica un elemento informazioni sul dispositivo in DeviceInfoSet.

Questo parametro è facoltativo e può essere NULL. Se questo parametro viene specificato, SetupDiGetClassDevPropertySheets recupera gli handle delle proprietà associati al dispositivo specificato. Se questo parametro è NULL, SetupDiGetClassDevPropertySheets recupera gli handle delle proprietà associati alla classe di installazione del dispositivo specificata in DeviceInfoSet.

[in] PropertySheetHeader

Puntatore a una struttura PROPERTYSHEETHEADER. Vedere la sezione osservazioni per informazioni sulla matrice fornita dal chiamante di handle della finestra delle proprietà associata a questa struttura.

Per altre informazioni su questa struttura e le finestre delle proprietà in generale, vedere Microsoft Windows SDK.

[in] PropertySheetHeaderPageListSize

Numero massimo di handle che la matrice fornita dal chiamante degli handle della finestra delle proprietà può contenere.

[out, optional] RequiredSize

Puntatore a una variabile di tipo DWORD che riceve il numero di finestre delle proprietà associate all'elemento di informazioni sul dispositivo specificato o alla classe di installazione del dispositivo del set di informazioni del dispositivo specificato. Il puntatore è facoltativo e può essere NULL.

[in] PropertySheetType

Flag che indica uno dei tipi seguenti di finestre delle proprietà.

Tipo di finestra delle proprietà	Significato
DIGCDP_FLAG_ADVANCED	Finestre delle proprietà avanzate.
DIGCDP_FLAG_BASIC	Finestre delle proprietà di base. Supportato solo in Microsoft Windows 95 e Windows 98. Non usare in Windows 2000 e versioni successive di Windows.
DIGCDP_FLAG_REMOTE_ADVANCED	Finestre delle proprietà avanzate in un computer remoto.

Valore restituito

Se ha esito positivo, la funzione restituisce TRUE. In caso contrario, la funzione restituisce FALSE. Chiamare GetLastError per ottenere il codice di errore.

Osservazioni

Una struttura PROPERTYSHEETHEADER contiene due membri associati a una matrice fornita dal chiamante utilizzata dalla funzione per restituire gli handle delle finestre delle proprietà. Il membro è un puntatore a una matrice fornita dal chiamante di handle della finestra delle proprietà e il valore di input del membro nPages specifica il numero di handle già contenuti nella matrice di handle. La funzione aggiunge handle della finestra delle proprietà alla matrice handle a partire dall'elemento della matrice il cui indice di matrice è il valore di input di nPages. La funzione aggiunge handle alla matrice in ordine consecutivo fino a quando la matrice non è piena o gli handle di tutte le pagine della finestra delle proprietà richieste sono state aggiunte alla matrice. Il numero massimo di handle della finestra delle proprietà che la funzione può restituire è uguale a (PropertySheetHeaderPageListSize - (valore di input di nPages)).

Se la matrice di handle è sufficientemente grande da contenere gli handle di tutte le pagine della finestra delle proprietà richieste, la funzione :

Aggiunge gli handle alla matrice di handle.
Imposta nPages sul numero totale di handle nella matrice.
Imposta RequiredSize sul numero di handle restituiti.
Restituisce TRUE.

Se la matrice di handle non è sufficientemente grande da contenere gli handle di tutte le pagine della finestra delle proprietà specificate, la funzione :

Aggiunge tutti gli handle che la matrice può contenere.
Imposta nPages su PropertySheetHeaderPageListSize.
Imposta RequiredSize sul numero totale di pagine della finestra delle proprietà richieste. Il numero di handle non restituiti dalla funzione è uguale a (RequiredSize - PropertySheetHeaderPageListSize - (valore di input di nPages)).
Imposta il codice di errore su ERROR_INSUFFICIENT_BUFFER.
Restituisce FALSE.

Nota

L'intestazione setupapi.h definisce SetupDiGetClassDevPropertySheets 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
client minimo supportato	Disponibile in Microsoft Windows 2000 e versioni successive di Windows.
piattaforma di destinazione	Desktop
intestazione	setupapi.h (include Setupapi.h)
libreria	Setupapi.lib

Vedere anche

SP_DEVINFO_DATA

Condividi tramite