Metodo IStillImageW::GetDeviceValue (sti.h)
Il metodo IStillImage::GetDeviceValue restituisce informazioni del Registro di sistema associate a un dispositivo di immagine ancora specificato.
Sintassi
HRESULT GetDeviceValue(
[in] LPWSTR pwszDeviceName,
[in] LPWSTR pValueName,
[out] LPDWORD pType,
[out] LPBYTE pData,
[in, out] LPDWORD cbData
);
Parametri
[in] pwszDeviceName
Puntatore fornito dal chiamante a una stringa che rappresenta un nome di dispositivo interno, ottenuto chiamando IStillImage::GetSTILaunchInformation o IStillImage::GetDeviceList.
[in] pValueName
Puntatore fornito dal chiamante a una stringa che rappresenta un nome del valore del Registro di sistema.
[out] pType
Riceve una costante che rappresenta il tipo di dati del valore del Registro di sistema restituito.
[out] pData
Puntatore fornito dal chiamante a un buffer per ricevere un valore restituito.
[in, out] cbData
Dimensioni fornite dal chiamante, in byte, del buffer a cui fa riferimento pData. Il metodo modifica questo valore per rappresentare le dimensioni dei dati restituiti. Se la dimensione del buffer specificata è troppo piccola, il metodo fornisce le dimensioni del buffer necessarie e restituisce un codice di errore.
Valore restituito
Se l'operazione ha esito positivo, il metodo restituisce S_OK. In caso contrario, restituisce uno dei codici di errore con prefisso STIERR definiti in stierr.h.
Commenti
Lo scopo del metodo IStillImage::GetDeviceValue consiste nel restituire i valori attualmente assegnati alle voci del Registro di sistema specifiche del dispositivo per i dispositivi ancora immagine. Il metodo chiama RegQueryValueEx (descritto nella documentazione di Microsoft Windows SDK).
Il metodo IStillImage::GetDeviceValue può restituire una stringa ANSI o Unicode. Può restituire una stringa Unicode solo se il codice viene compilato come Unicode con Unicode definito.
Prima di chiamare IStillImage::GetDeviceValue, i client dell'interfaccia COM IStillImage devono chiamare IStillImage::StiCreateInstance per ottenere un puntatore dell'interfaccia IStillImage.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | sti.h (include Sti.h) |