Metodo IStillImageW::CreateDevice (sti.h)

Il metodo IStillImage::CreateDevice crea un'istanza dell'oggetto COM che definisce l'interfaccia COM IStiDevice e restituisce un puntatore all'interfaccia.

Sintassi

HRESULT CreateDevice(
  [in]           LPWSTR     pwszDeviceName,
                 DWORD      dwMode,
  [out]          PSTIDEVICE *pDevice,
  [in, optional] LPUNKNOWN  punkOuter
);

Parametri

[in] pwszDeviceName

Puntatore fornito dal chiamante a una stringa che rappresenta un nome di dispositivo interno, ottenuto chiamando IStillImage::GetSTILaunchInformation o IStillImage::GetDeviceList.

dwMode

Valore costante fornito dal chiamante che indica le modalità di trasferimento in cui deve essere usato il dispositivo. I valori seguenti sono validi.

Mode	Descrizione
STI_DEVICE_CREATE_BOTH	Il dispositivo viene aperto per ottenere lo stato e trasferire i dati.
STI_DEVICE_CREATE_DATA	Il dispositivo viene aperto solo per i trasferimenti di dati.
STI_DEVICE_CREATE_STATUS	Il dispositivo viene aperto solo per ottenere informazioni sullo stato.

[out] pDevice

Riceve un puntatore all'interfaccia COM IStiDevice.

[in, optional] punkOuter

Facoltativo, puntatore fornito dal chiamante al "controllo sconosciuto" per l'aggregazione di oggetti. Vedere la sezione Osservazioni seguenti.

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

Per usare l'interfaccia IStiDevice , un'applicazione deve prima chiamare IStillImage::StiCreateInstance per ottenere un puntatore all'interfaccia IStillImage , quindi chiamare IStillImage::CreateDevice per ottenere un puntatore all'interfaccia IStiDevice . Il puntatore ricevuto in pDevice viene usato successivamente quando si chiamano metodi IStiDevice , come illustrato nel codice immagine di esempio, per ottenere l'accesso al dispositivo specificato.

Se si vuole creare un oggetto COM aggregato che include IStiDevice, è necessario fornire un puntatore al "controllo sconosciuto" in punkOuter. Nella maggior parte dei casi non si creerà un oggetto aggregato, quindi punkOuter dovrebbe essere NULL. L'aggregazione degli oggetti e il controllo sconosciuto sono descritti nella documentazione Microsoft Windows SDK e nella specifica del modello a oggetti componente.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	sti.h (include Sti.h)

Vedi anche

IStiDevice::Release

IStillImageW