Compartilhar via


Método IStiDevice::GetStatus (sti.h)

O método IStiDevice::GetStatus retorna as informações de status de um dispositivo de imagem parada.

Sintaxe

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

Parâmetros

[in, out] pDevStatus

Ponteiro fornecido pelo chamador para uma estrutura STI_DEVICE_STATUS . O chamador deve definir os membros dwSize e StatusMask .

Retornar valor

Se a operação for bem-sucedida, o método retornará S_OK. Caso contrário, ele retornará um dos códigos de erro prefixados por STIERR definidos em stierr.h.

Comentários

O método IStiDevice::GetStatus retorna informações de status do dispositivo na estrutura de STI_DEVICE_STATUS fornecida pelo chamador. Ele obtém o status chamando IStiUSD::GetStatus, que é exportado por minidrivers fornecidos pelo fornecedor.

Antes de chamar IStiDevice::GetStatus, os clientes da interface COM IStiDevice devem chamar IStillImage::CreateDevice para obter um ponteiro de interface IStiDevice , que fornece acesso a um dispositivo especificado.

Uma chamada para IStiDevice::GetStatus deve ser precedida por uma chamada para IStiDevice::LockDevice e seguida por uma chamada para IStiDevice::UnLockDevice.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho sti.h (inclua Sti.h)