IStillImageW::LaunchApplicationForDevice 메서드(sti.h)

IStillImage::LaunchApplicationForDevice 메서드는 지정된 스틸 이미지 디바이스에 대해 지정된 애플리케이션을 시작합니다.

구문

HRESULT LaunchApplicationForDevice(
  [in] LPWSTR      pwszDeviceName,
  [in] LPWSTR      pwszAppName,
  [in] LPSTINOTIFY pStiNotify
);

매개 변수

[in] pwszDeviceName

IStillImage::GetSTILaunchInformation 또는 IStillImage::GetDeviceList를 호출하여 가져온 내부 디바이스 이름을 나타내는 문자열에 대한 호출자 제공 포인터입니다.

[in] pwszAppName

IStillImage::RegisterLaunchApplication을 호출하여 등록된 애플리케이션의 짧은 이름을 나타내는 문자열에 대한 호출자 제공 포인터입니다.

[in] pStiNotify

디바이스 이벤트를 설명하는 STINOTIFY 구조체에 대한 호출자 제공 포인터입니다. 일반적으로 이벤트의 GUID는 IStiDevice::GetLastNotificationData를 호출하여 가져옵니다.

반환 값

작업이 성공하면 메서드는 S_OK 반환합니다. 그렇지 않으면 stierr.h에 정의된 STIERR 접두사 오류 코드 중 하나를 반환합니다.

설명

IStillImage::LaunchApplicationForDevice 메서드는 IStillImage::RegisterLaunchApplication을 호출하여 자신을 등록한 애플리케이션만 시작할 수 있습니다. 지정된 이벤트는 지정된 디바이스에서 지원하는 이벤트여야 합니다. 메서드는 디바이스 이벤트의 발생을 모방하며 디바이스에서 이벤트를 가로채서 다시 라우팅하는 애플리케이션에 유용합니다. 예를 들어 사용자가 스캐너를 시작할 때 이러한 애플리케이션은 스캔한 이미지를 저장하거나, 복사본을 만들거나, 팩스를 보낼지 여부를 사용자에게 요청할 수 있습니다.

IStillImage::LaunchApplicationForDevice를 호출하기 전에 IStillImage COM 인터페이스의 클라이언트는 IStillImage::StiCreateInstance를 호출하여 IStillImage 인터페이스 포인터를 가져와야 합니다.

예제

HRESULT hRes;
hRes = pStiDevice->GetLastNotificationData(&pNotify);
if (!SUCCEEDED(hRes))
{
    DisplayOutput("->GetLastNotificationData returned %xh %u",
        hReturn,hReturn);
}

// Process or filter events here

// Send event on to app
hRes = pSti->LaunchApplicationForDevice(pStiInfoPtr->szDeviceInternalName,
     L"AppName",
     pNotify);
if (!SUCCEEDED(hRes))
{
    DisplayOutput("->LaunchApplicationForDevice on %S returned %xh %u",
        pStiInfoPtr->szDeviceInternalName,hReturn,hReturn);
}

요구 사항

요구 사항	값
대상 플랫폼	데스크톱
머리글	sti.h(Sti.h 포함)