장치 프로퍼티

Microsoft® DirectInput® 장치의 프로퍼티에는, 데이터 버퍼의 사이즈, 축이 돌려주는 값의 범위와 세분도, 축데이터가 상대인가 절대인가, 및 조이스틱축의데드 존과포화가 있다. 특수한 장치는, 이외의 프로퍼티를 가지는 일도 있다. DirectInput 로 정의되는 프로퍼티의 리스트에 대해서는, 「IDirectInputDevice8::GetProperty 」를 참조할것.

1 개의 예외 (force feedback 장치의 게인 프로퍼티)를 제외해, 프로퍼티는, 장치가 릴리즈 된 상태에 있는 경우에 한정해 변경할 수 있다.

IDirectInputDevice8::SetProperty 메서드 또는 IDirectInputDevice8::GetProperty 메서드를 호출하기 전에,DIPROPHEADER 구조체와 1 개 이상의 데이터의 요소로 구성되는 프로퍼티 구조체를 설정할 필요가 있다. 입력 장치에는 많은 프로퍼티가 있으므로,IDirectInputDevice8::SetProperty 는, 이러한 프로퍼티를 정의하는 모든 종류의 구조체에 대해서 기능할 수 있어야 한다. DIPROPHEADER 구조체의 목적은, 프로퍼티 구조체의 사이즈와 데이터의 해석 방법을 정의하는 것이다.

DirectInput 에는, 이하의 사전 정의된 프로퍼티 구조체가 있다.

• DIPROPDWORD 는, 버퍼 사이즈 등 단일의 값을 요구하는 프로퍼티에 대한 DIPROPHEADER 및 DWORD 데이터 멤버를 포함한 구조체를 정의한다.
• DIPROPRANGE 는, 프로퍼티의 범위를 정의하는 것이어, 2 개의 값 (최대치와 최소 값)을 요구한다. DIPROPHEADER 구조체와 2 개의 LONG 데이터 멤버로 구성된다.
• DIPROPGUIDANDPATH 는, DirectInput 로 지원되지 않은 HID (Human Interface Device)에 대해서 애플리케이션이 조작을 실행할 수 있는, 특수한 프로퍼티 구조체이다. 이 구조체는,DIPROPHEADER 구조체, 글로벌 일의 식별자 (GUID), 및 패스를 나타내는 Unicode 캐릭터 라인으로 구성된다.
• DIPROPSTRING 는, Unicode 캐릭터 라인 프로퍼티이다. 이 구조체는,DIPROPHEADER 구조체와 Unicode 캐릭터 라인으로 구성된다.

IDirectInputDevice8::SetProperty 의 경우, 프로퍼티 구조체의 데이터 멤버는, 개발자가 설정하는 값이다. IDirectInputDevice8::GetProperty 의 경우는, 현재의 값이 데이터 멤버에 반환된다.

IDirectInputDevice8::GetProperty 또는 IDirectInputDevice8::SetProperty 를 호출하기 전에,DIPROPHEADER 구조체를 다음의 값으로 초기화해 두지 않으면 안 된다.

• 프로퍼티 구조체의 사이즈.
• DIPROPHEADER 구조체 자체의 사이즈.
• 개체 식별자.
• 개체 식별자의 해석 방법을 지시하는 값.

장치 전체로부터 프로퍼티를 취득 또는 설정하는 경우, 개체 식별자 dwHow 는 제로이며,dwObj 멤버는 DIPH_DEVICE 이다. 1 개의 장치 개체 (예를 들어, 특정의 축)에 대해서 프로퍼티를 설정 또는 얻어온다 경우는,dwObj 와 dwHow 의 편성값에 의해, 그 개체를 식별할 수 있다. 더 자세한 정보는, 「DIPROPHEADER」를 참조할것.

프로퍼티 구조체의 설정 후, 취득 또는 변경하는 프로퍼티의 식별자와 함께, 구조체의 헤더의 주소를 IDirectInputDevice8::GetProperty 또는 IDirectInputDevice8::SetProperty 에 건네준다.

IDirectInputDevice8::SetProperty 및 IDirectInputDevice8::GetProperty 에 건네주는 프로퍼티를 식별하기 위해서, 다음의 값을 사용한다.

• DIPROP_BUFFERSIZE. 「버퍼링 데이터와 직접 데이터」도 참조할것. 버퍼 사이즈의 설정에는,IDirectInputDevice8::SetActionMap 메서드도 사용할 수 있다.
• DIPROP_AXISMODE. 「상대 좌표와 절대 좌표」도 참조할것.
• DIPROP_CALIBRATIONMODE.
• DIPROP_GRANULARITY.
• DIPROP_FFGAIN.
• DIPROP_FFLOAD.
• DIPROP_AUTOCENTER.
• DIPROP_RANGE.
• DIPROP_DEADZONE.
• DIPROP_SATURATION.

마지막 3 개의 프로퍼티의 더 자세한 정보는, 「조이스틱축데이터의 해석」도 참조할것.

다음 샘플 코드에서는, 10 개의 데이터 항목을 보관 유지하도록(듯이) 장치의 버퍼 사이즈를 설정한다.

DIPROPDWORD  dipdw; 
HRESULT      hr; 
dipdw.diph.dwSize = sizeof(DIPROPDWORD); 
dipdw.diph.dwHeaderSize = sizeof(DIPROPHEADER); 
dipdw.diph.dwObj = 0; 
dipdw.diph.dwHow = DIPH_DEVICE; 
dipdw.dwData = 10; 
hr = lpdiDevice->SetProperty(DIPROP_BUFFERSIZE, &dipdw.diph);