Metodo IStiDevice::GetStatus (sti.h)

Il metodo IStiDevice::GetStatus restituisce informazioni sullo stato di un dispositivo ancora immagine.

Sintassi

HRESULT GetStatus(
  [in, out] PSTI_DEVICE_STATUS pDevStatus
);

Parametri

[in, out] pDevStatus

Puntatore fornito dal chiamante a una struttura STI_DEVICE_STATUS . Il chiamante deve impostare i membri dwSize e StatusMask .

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

Il metodo IStiDevice::GetStatus restituisce informazioni sullo stato del dispositivo nella struttura STI_DEVICE_STATUS fornita dal chiamante. Ottiene lo stato chiamando IStiUSD::GetStatus, esportato dai minidriver forniti dal fornitore.

Prima di chiamare IStiDevice::GetStatus, i client dell'interfaccia COM IStiDevice devono chiamare IStillImage::CreateDevice per ottenere un puntatore all'interfaccia IStiDevice , che fornisce l'accesso a un dispositivo specificato.

Una chiamata a IStiDevice::GetStatus deve essere preceduta da una chiamata a IStiDevice::LockDevice e seguita da una chiamata a IStiDevice::UnLockDevice.

Requisiti