DirectInput DirectInput C/C++ 레퍼런스 반환값의 열거형 [목차열람] [주소복사] [슬롯비우기] |
Microsoft DirectX 9.0 |
다음의 일람은, Microsoft® DirectInput® 메서드와 함수가 돌려주는 HRESULT 값을 나타낸다. 에러는 부의 값에 의해 나타나 결합할 수가 없다.
각 메서드 또는 함수가 돌려주는 에러값의 일람에 대해서는, 각각의 설명을 참조할것. 문서에서의 에러 코드의 일람은, 완전한 것은 아니다. 예를 들어, DirectInput 의 어느 메서드도 DIERR_OUTOFMEMORY 를 돌려주지만, 문서에서는, 이 에러 코드는 그 메서드의 가능한 반환값으로 명시되지 않다.
구문
typedef enum { DI_BUFFEROVERFLOW, DI_DOWNLOADSKIPPED, DI_EFFECTRESTARTED, DI_NOEFFECT, DI_NOTATTACHED, DI_OK, DI_POLLEDDEVICE, DI_PROPNOEFFECT, DI_SETTINGSNOTSAVED, DI_TRUNCATED, DI_TRUNCATEDANDRESTARTED, DI_WRITEPROTECT, DIERR_ACQUIRED, DIERR_ALREADYINITIALIZED, DIERR_BADDRIVERVER, DIERR_BETADIRECTINPUTVERSION, DIERR_DEVICEFULL, DIERR_DEVICENOTREG, DIERR_EFFECTPLAYING, DIERR_GENERIC, DIERR_HANDLEEXISTS, DIERR_HASEFFECTS, DIERR_INCOMPLETEEFFECT, DIERR_INPUTLOST, DIERR_INVALIDPARAM, DIERR_MAPFILEFAIL, DIERR_MOREDATA, DIERR_NOAGGREGATION, DIERR_NOINTERFACE, DIERR_NOTACQUIRED, DIERR_NOTBUFFERED, DIERR_NOTDOWNLOADED, DIERR_NOTEXCLUSIVEACQUIRED, DIERR_NOTFOUND, DIERR_NOTINITIALIZED, DIERR_OBJECTNOTFOUND, DIERR_OLDDIRECTINPUTVERSION, DIERR_OTHERAPPHASPRIO, DIERR_OUTOFMEMORY, DIERR_READONLY, DIERR_REPORTFULL, DIERR_UNPLUGGED, DIERR_UNSUPPORTED, E_HANDLE, E_PENDING, E_POINTER } Return Values;
정수
- DI_BUFFEROVERFLOW
장치 버퍼가 오버플로우 해, 일부의 입력이 없어졌다. 이 값은, 표준의 COM 반환값인 S_FALSE 에 동일하다.
- DI_DOWNLOADSKIPPED
이펙트의 파라미터의 갱신은 성공했지만, 이 이펙트에 관련하는 장치가 배타 모드로 취득되지 않기 때문에, 이 이펙트를 다운로드할 수 없다.
- DI_EFFECTRESTARTED
이펙트를 정지해, 그 파라미터의 갱신을 실시해, 그 후 이 이펙트를 재개했다.
- DI_NOEFFECT
이 조작에 이펙트는 없다. 이 값은, 표준의 구성 요소 개체 모델 (COM) 반환값인 S_FALSE 에 동일하다.
- DI_NOTATTACHED
장치는 존재하지만, 현재는Attach되지 않다. 이 값은, 표준의 COM 반환값인 S_FALSE 에 동일하다.
- DI_OK
조작은 완전하게 종료했다. 이 값은, 표준의 COM 반환값인 S_OK 에 동일하다.
- DI_POLLEDDEVICE
장치는, 폴링 대상 장치이다. 그 결과, 장치 버퍼링으로 데이터는 수집되지 않고, 이벤트는,IDirectInputDevice8::Poll 메서드가 불려 갈 때까지 통지되지 않는다.
- DI_PROPNOEFFECT
장치 프로퍼티의 변경은 효과가 없었다. 이 값은, 표준의 COM 반환값인 S_FALSE 에 동일하다.
- DI_SETTINGSNOTSAVED
액션 맵은 장치에 적용되었지만, 설정 정보는 보존되지 않았다.
- DI_TRUNCATED
이펙트의 파라미터의 갱신은 성공했지만, 파라미터중 장치의 능력을 넘고 있는 것이 있어, 그것들은 지원 되는 가장 가까운 값에 말 수 있었다.
- DI_TRUNCATEDANDRESTARTED
DI_EFFECTRESTARTED | DI_TRUNCATED 에 동일하다.
- DI_WRITEPROTECT
설정을 변경할 수 없는 것을 나타내는 성공 코드.
- DIERR_ACQUIRED
조작은, 장치가 취득 상태의 사이는 실행할 수 없다.
- DIERR_ALREADYINITIALIZED
이 개체는 초기화가 끝난 상태이다.
- DIERR_BADDRIVERVER
호환성이 없는 드라이버 버전, 또는 부적격인가 불완전한 드라이버 구성 요소가 원인으로, 개체는 생성 할 수 없었다.
- DIERR_BETADIRECTINPUTVERSION
애플리케이션은, DirectInput 의 지원되지 않은 릴리스전의 버전용으로 생성 된 것이다.
- DIERR_DEVICEFULL
장치는 풀이다.
- DIERR_DEVICENOTREG
장치 또는 장치 인스턴스가 DirectInput 에 등록되지 않았다. 이 값은, 표준의 COM 반환값인 REGDB_E_CLASSNOTREG 에 동일하다.
- DIERR_EFFECTPLAYING
파라미터는, 메모리내에서는 갱신되었지만, 장치에는 다운로드되지 않았다. 장치가 재생중의 이펙트의 갱신을 지원 하고 있지 않기 때문이다.
- DIERR_GENERIC
DirectInput 서브 시스템으로 원인 불명의 에러가 발생했다. 이 값은, 표준의 COM 반환값인 E_FAIL 에 동일하다.
- DIERR_HANDLEEXISTS
장치는, 이미 자신에게 이벤트 통지를 관련짓고 있다. 이 값은, 표준의 COM 반환값인 E_ACCESSDENIED 에 동일하다.
- DIERR_HASEFFECTS
장치는, 이펙트가 장치에 Attach 되고 있기 위해서(때문에) 재초기화할 수 없다.
- DIERR_INCOMPLETEEFFECT
필수 정보가 없기 때문에, 이펙트를 다운로드할 수 없었다. 예를 들어, 이펙트에 관련하는 축이 없기도 하고, 타입 고유의 정보가 주어지지 않은 경우.
- DIERR_INPUTLOST
입력 장치에의 액세스가 없어졌다. 재취득해야 한다.
- DIERR_INVALIDPARAM
무효인 파라미터가 돌아오는 함수에 건네졌는지, 개체가 그 함수를 호출할 수 있는 상태에 없었다. 이 값은, 표준의 COM 반환값인 E_INVALIDARG 에 동일하다.
- DIERR_MAPFILEFAIL
벤더가 제공한 장치의 액션 맵 파일을 읽기중인가, 장치의 사용자 구성 액션 맵 파일을 읽기중 또는 쓰기중에 에러가 발생했다.
- DIERR_MOREDATA
요구 정보의 일부가 버퍼에 들어가지 않았다.
- DIERR_NOAGGREGATION
개체는 집성화를 지원 하고 있지 않다.
- DIERR_NOINTERFACE
개체는, 지정된 인터페이스를 지원 하고 있지 않다. 이 값은, 표준의 COM 반환값인 E_NOINTERFACE 에 동일하다.
- DIERR_NOTACQUIRED
조작은, 장치가 취득되지 않는 한 실행할 수 없다.
- DIERR_NOTBUFFERED
장치는 버퍼링되지 않다. 버퍼링을 유효하게 하려면 , DIPROP_BUFFERSIZE 프로퍼티를 설정한다.
- DIERR_NOTDOWNLOADED
이펙트가 다운로드되지 않다.
- DIERR_NOTEXCLUSIVEACQUIRED
조작은, 장치가 DISCL_EXCLUSIVE 모드로 취득되지 않으면 실행할 수 없다.
- DIERR_NOTFOUND
요구된 개체는 존재하지 않는다.
- DIERR_NOTINITIALIZED
이 개체는 초기화되지 않다.
- DIERR_OBJECTNOTFOUND
요구된 개체는 존재하지 않는다.
- DIERR_OLDDIRECTINPUTVERSION
애플리케이션은, 보다 새로운 버전의 DirectInput 를 필요로 한다.
- DIERR_OTHERAPPHASPRIO
다른 애플리케이션의 우선 레벨이 높기 때문에, 이 호출을 실행할 수 없다. 이 값은, 표준의 DirectInput 반환값인 E_ACCESSDENIED 에 동일하다. 이 에러가 돌려받는 것은, 애플리케이션의 장치에 대한 액세스권이 foreground 액세스권인 것에도 불구하고, 백그라운드에 있을 때 장치를 취득하려고 했을 경우이다.
- DIERR_OUTOFMEMORY
DirectInput 서브 시스템이 호출을 완료하는데 충분한 메모리를 할당할 수가 없었다. 이 값은, 표준의 COM 반환값인 E_OUTOFMEMORY 에 동일하다.
- DIERR_READONLY
지정의 프로퍼티는 변경할 수 없다. 이 값은, 표준의 COM 반환값인 E_ACCESSDENIED 에 동일하다.
- DIERR_REPORTFULL
보내지는 정보가, 장치에 보낼 수가 있는 정보보다 많다.
- DIERR_UNPLUGGED
장치가 접속되지 않기 때문에, 조작을 완료할 수 없었다.
- DIERR_UNSUPPORTED
호출한 함수는 이 시점에서는 지원하지 않는다. 이 값은, 표준의 COM 반환값인 E_NOTIMPL 에 동일하다.
- E_HANDLE
이 파라미터는, 이 프로세스에 관계하는 유효한 최상정도의 윈도우 핸들이어야 한다.
- E_PENDING
데이터는, 아직 사용할 수 없다.
- E_POINTER
무효인 포인터 (보통은 NULL)가 파라미터로서 건네받았다.
열거형의 정보
최저한의 operating system Windows 98, Windows 2000, Windows XP