Metodo IStillImageW::GetSTILaunchInformation (sti.h)

Il metodo IStillImage::GetSTILaunchInformation restituisce il motivo per cui è stata avviata l'applicazione di immagini ancora chiamante, se è stato avviato il monitoraggio eventi dell'immagine ancora.

Sintassi

HRESULT GetSTILaunchInformation(
  [out]           LPWSTR pwszDeviceName,
  [out, optional] DWORD  *pdwEventCode,
  [out]           LPWSTR pwszEventName
);

Parametri

[out] pwszDeviceName

Puntatore fornito dal chiamante a un buffer, STI_MAX_INTERNAL_NAME_LENGTH byte in lunghezza, per ricevere il nome del dispositivo interno del dispositivo ancora immagine per cui è stata avviata l'applicazione.

[out, optional] pdwEventCode

Riservato per utilizzi futuri.

[out] pwszEventName

Puntatore fornito dal chiamante a un buffer sufficiente per ricevere una rappresentazione stringa di un GUID. Il GUID rappresenta gli eventi del dispositivo di immagine continua per cui è stata avviata l'applicazione.

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

Se il monitoraggio eventi immagine ancora avviato l'applicazione, i valori pwszDeviceName e pwszEventName identificano gli argomenti della riga di comando /StiEvent e /StiEvent (vedere la descrizione di IStillImage::RegisterLaunchApplication). Se il monitoraggio eventi non ha avviato l'applicazione, il metodo restituisce STIERR_GENERIC.

Prima di chiamare IStillImage::GetSTILaunchInformation, i client dell'interfaccia COM IStillImage devono chiamare IStillImage::StiCreateInstance per ottenere un puntatore dell'interfaccia IStillImage.

Requisiti

Piattaforma di destinazione	Desktop
Intestazione	sti.h (include Sti.h)