IStillImageW::GetDeviceList メソッド (sti.h)
IStillImage::GetDeviceList メソッドは、インストールされているすべての静止画像デバイスのハードウェア特性を返します。
構文
HRESULT GetDeviceList(
DWORD dwType,
DWORD dwFlags,
[out] DWORD *pdwItemsReturned,
[out] LPVOID *ppBuffer
);
パラメーター
dwType
予約済みパラメーターは NULL を使用します。
dwFlags
予約済みパラメーターは NULL を使用します。
[out] pdwItemsReturned
ppBuffer によって参照されるバッファーに指定されたSTI_DEVICE_INFORMATION構造体の数を受け取ります。
[out] ppBuffer
STI によって割り当てられたバッファーへのハンドルを受け取ります。 このバッファーには、 STI_DEVICE_INFORMATION 構造体の配列が含まれます。
戻り値
操作が成功した場合、メソッドは S_OKを返します。 それ以外の場合は、 stierr.h で定義されている STIERR プレフィックス付きエラー コードのいずれかを返します。
注釈
IStillImage::GetDeviceList メソッドは、インストールされている静止画像デバイスごとにSTI_DEVICE_INFORMATION構造体を返します。 構造体の内容は、通常、ユーザー インターフェイスの表示を作成したり、デバイスの内部名を検索したりするために使用されます。
IStillImage::GetDeviceList を呼び出す前に、IStillImage COM インターフェイスのクライアントが IStillImage::StiCreateInstance を呼び出して IStillImage インターフェイス ポインターを取得する必要があります。
呼び出し元が ppBuffer によって参照されるSTI_DEVICE_INFORMATION構造体の配列の使用を完了したら、LocalFree を呼び出して配列の割り当てを解除する必要があります (Microsoft Windows SDKドキュメントで説明)。
要件
要件 | 値 |
---|---|
対象プラットフォーム | デスクトップ |
Header | sti.h (Sti.h を含む) |