Função StiCreateInstanceW (sti.h)
A função StiCreateInstance cria uma instância do objeto COM que define a interface IStillImage e retorna um ponteiro para a interface.
Sintaxe
HRESULT StiCreateInstanceW(
HINSTANCE hinst,
DWORD dwVer,
IStillImageW **ppSti,
LPUNKNOWN punkOuter
);
Parâmetros
hinst
Identificador de instância fornecido pelo chamador do processo de chamada. Esse identificador é obtido chamando GetModuleHandle(NULL).
dwVer
Número de versão de STI fornecido pelo chamador. Esse valor deve ser STI_VERSION, definido em Sti.h.
ppSti
Recebe um ponteiro para a interface IStillImage.
punkOuter
Opcional, o ponteiro fornecido pelo chamador para o "controlando desconhecido" para agregação de objeto. Consulte a seção comentários do a seguir.
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
Para um aplicativo usar a interface IStillImage, ele deve primeiro chamar a função StiCreateInstance para obter um ponteiro para a interface. O ponteiro recebido em ppSti é usado posteriormente ao chamar métodos IStillImage, conforme ilustrado no exemplo a seguir:
PSTI pSti = NULL;
DWORD dwStiTotal = 0; // total number of STI devices found
PVOID pStiInfo = NULL; // STI device info buffer
HRESULT hres = StiCreateInstance(GetModuleHandle(NULL), STI_VERSION, &pSti, NULL);
...
hhes = pSti->GetDeviceList(0, 0, &dwStiTotal, &pStiInfo);
Se você quiser criar um objeto COM agregado que inclua IStillImage, forneça um ponteiro para o "controlando desconhecido" em punkOuter. Na maioria dos casos, você não criará um objeto agregado, portanto, punkOuter deve ser NULL. A agregação de objeto e o controle desconhecido são descritos no artigo de agregação de e no especificação do modelo de objeto do componente.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | sti.h (inclua Sti.h) |