Método IStillImageW::CreateDevice (sti.h)
O método IStillImage::CreateDevice cria uma instância do objeto COM que define a Interface COM IStiDevice e retorna um ponteiro para a interface .
Sintaxe
HRESULT CreateDevice(
[in] LPWSTR pwszDeviceName,
DWORD dwMode,
[out] PSTIDEVICE *pDevice,
[in, optional] LPUNKNOWN punkOuter
);
Parâmetros
[in] pwszDeviceName
Ponteiro fornecido pelo chamador para uma cadeia de caracteres que representa um nome de dispositivo interno, obtido chamando IStillImage::GetSTILaunchInformation ou IStillImage::GetDeviceList.
dwMode
Valor constante fornecido pelo chamador que indica os Modos de Transferência nos quais o dispositivo deve ser usado. Os valores a seguir são válidos.
| Mode | Descrição |
|---|---|
| STI_DEVICE_CREATE_BOTH | O dispositivo está sendo aberto para obter status e transferir dados. |
| STI_DEVICE_CREATE_DATA | O dispositivo está sendo aberto somente para transferências de dados. |
| STI_DEVICE_CREATE_STATUS | O dispositivo está sendo aberto apenas para obter informações de status. |
[out] pDevice
Recebe um ponteiro para a interface COM IStiDevice.
[in, optional] punkOuter
Opcional, ponteiro fornecido pelo chamador para o "controle desconhecido" para agregação de objeto. Consulte a seção Comentários a seguir.
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
Para um aplicativo usar a interface IStiDevice , ele deve primeiro chamar IStillImage::StiCreateInstance para obter um ponteiro para a interface IStillImage e, em seguida, chamar IStillImage::CreateDevice para obter um ponteiro para a interface IStiDevice . O ponteiro recebido no pDevice é usado posteriormente ao chamar métodos IStiDevice , conforme ilustrado no código de imagem ainda de exemplo, para obter acesso ao dispositivo especificado.
Se você quiser criar um objeto COM agregado que inclua IStiDevice, forneça um ponteiro para o "controlando desconhecido" no punkOuter. Na maioria dos casos, você não criará um objeto de agregação, portanto , punkOuter deve ser NULL. A agregação de objeto e o controle desconhecido são descritos na documentação do SDK do Microsoft Windows e na Especificação do Modelo de Objeto do Componente.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | sti.h (inclua Sti.h) |