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

IStillImage::GetSTILaunchInformation 메서드는 스틸 이미지 이벤트 모니터가 시작된 경우 호출 스틸 이미지 애플리케이션이 시작된 이유를 반환합니다.

구문

HRESULT GetSTILaunchInformation(
  [out]           LPWSTR pwszDeviceName,
  [out, optional] DWORD  *pdwEventCode,
  [out]           LPWSTR pwszEventName
);

매개 변수

[out] pwszDeviceName

애플리케이션이 시작된 스틸 이미지 디바이스의 내부 디바이스 이름을 수신하기 위해 버퍼에 대한 호출자 제공 포인터(길이가 바이트 STI_MAX_INTERNAL_NAME_LENGTH)입니다.

[out, optional] pdwEventCode

다음에 사용하도록 예약됩니다.

[out] pwszEventName

GUID의 문자열 표현을 받을 수 있을 만큼 큰 버퍼에 대한 호출자 제공 포인터입니다. GUID는 애플리케이션이 시작된 스틸 이미지 디바이스 이벤트를 나타냅니다.

반환 값

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

설명

스틸 이미지 이벤트 모니터가 애플리케이션을 시작한 경우 pwszDeviceName 및 pwszEventName 값 은 /StiDevice 및 /StiEvent 명령줄 인수를 식별합니다( IStillImage::RegisterLaunchApplication에 대한 설명 참조). 이벤트 모니터가 애플리케이션을 시작하지 않은 경우 메서드는 STIERR_GENERIC 반환합니다.

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

요구 사항

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