Metodo IStillImageW::GetSTILaunchInformation (sti.h)

Articolo
02/07/2025

Il metodo IStillImage::GetSTILaunchInformation restituisce il motivo per cui è stata avviata l'applicazione di immagine ancora chiamante, se il monitoraggio eventi immagine è ancora 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 lunghezza in byte, per ricevere il nome interno del dispositivo immagine per il quale è stata avviata l'applicazione.

[out, optional] pdwEventCode

Riservato per uso futuro.

[out] pwszEventName

Puntatore fornito dal chiamante a un buffer sufficientemente grande da ricevere una rappresentazione di stringa di un GUID. Il GUID rappresenta il Still Image Device Events 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.

Osservazioni

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

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

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	sti.h (include Sti.h)

Condividi tramite