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

Artigo
02/07/2025

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

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.

Valor de retorno

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.

Observações

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
da Plataforma de Destino	Área de trabalho
cabeçalho	sti.h (inclua Sti.h)

Partilhar via