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)

Vedi anche

IStillImage::SetDeviceValue

IStillImageW