IDirectInputJoyConfig8::SetTypeInfo 메서드(dinputd.h)

아티클
01/10/2024

IDirectInputJoyConfig8::SetTypeInfo 메서드는 새 조이스틱 형식을 만들거나 기존 조이스틱 유형에 대한 정보를 다시 정의합니다.

구문

HRESULT SetTypeInfo(
  LPCWSTR          unnamedParam1,
  LPCDIJOYTYPEINFO unnamedParam2,
  DWORD            unnamedParam3,
  LPWSTR           unnamedParam4
);

매개 변수

unnamedParam1

형식의 이름을 가리킵니다. 형식의 이름은 종료 null 문자를 포함하여 MAX_JOYSTRING 문자를 초과할 수 없습니다. 형식 이름이 아직 없으면 생성됩니다. 미리 정의된 형식의 형식 정보는 변경할 수 없습니다. 이름은 "#" 문자로 시작할 수 없습니다. "#"으로 시작하는 형식은 DirectInput에서 예약됩니다.

unnamedParam2

조이스틱 유형에 대한 정보를 수신하는 구조를 가리킵니다.

unnamedParam3

설정할 값이 포함된 pjti가 가리키는 DIJOYTYPEINFO 구조체의 부분을 지정합니다.

DITC_REGHWSETTINGS

조이스틱에 대한 레지스트리 하드웨어 설정이 유효하다는 것을 나타냅니다.

DITC_CLSIDCONFIG

조이스틱 구성 CLSID가 유효함을 나타냅니다. 값이 모두 0이면 이 조이스틱 형식에 대한 사용자 지정 구성이 없습니다.

DITC_DISPLAYNAME

조이스틱 유형의 표시 이름이 유효하다는 것을 나타냅니다.

DITC_CALLOUT

조이스틱 형식의 콜아웃이 유효하다는 것을 나타냅니다.

unnamedParam4

형식 이름이 VID_xxxx&PID_yyyy 형식이 아닌 OEM 형식인 경우 이 매개 변수는 Dinput에서 할당한 VID_xxxx&PID_yyyy 형식으로 이름을 반환합니다. 이 VID_xxxx&PID_yyyy 이름은 SetConfig를 호출할 때 DIJOYCONFIG.wszType 필드에 사용해야 합니다.

반환 값

성공하면 DI_OK 반환합니다. 그렇지 않으면 다음 COM 오류 값 중 하나를 반환합니다.

반환 코드	설명
DIERR_NOTACQUIRED	조이스틱 구성을 획득하지 못했습니다. 조이스틱 구성에 대한 변경 내용을 애플리케이션 및 드라이버에 알리려면 먼저 IDirectInputJoyConfig8::Acquire 를 호출해야 합니다.
DIERR_INVALIDPARAM	하나 이상의 매개 변수가 잘못되었습니다.
DIERR_READONLY	미리 정의된 형식을 변경하려고 했습니다.

요구 사항


대상 플랫폼	데스크톱
머리글	dinputd.h(Dinputd.h 포함)

다음을 통해 공유