Metodo IStillImageW::GetSTILaunchInformation (sti.h)

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

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 di lunghezza, per ricevere il nome interno del dispositivo immagine per cui è stata avviata l'applicazione.

[out, optional] pdwEventCode

Riservato per utilizzi futuri.

[out] pwszEventName

Puntatore fornito dal chiamante a un buffer sufficientemente grande da ricevere una rappresentazione di stringa di un GUID. Il GUID rappresenta gli eventi del dispositivo 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 continua ha avviato l'applicazione, i valori pwszDeviceName e pwszEventName identificano gli argomenti della riga di comando /StiDevice 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 all'interfaccia IStillImage .

Requisiti