다음을 통해 공유

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

  • 아티클

IDirectInputJoyConfig8::OpenTypeKey 메서드는 조이스틱 형식과 연결된 레지스트리 키를 엽니다.

구문

HRESULT OpenTypeKey(
  LPCWSTR unnamedParam1,
  DWORD   unnamedParam2,
  PHKEY   unnamedParam3
);

매개 변수

unnamedParam1

형식의 이름을 가리킵니다. 형식의 이름은 종료 null 문자를 포함하여 MAX_PATH 문자를 초과할 수 없습니다. 이름은 "#" 문자로 시작할 수 없습니다. "#"으로 시작하는 형식은 DirectInput에서 예약됩니다.

unnamedParam2

레지스트리 보안 액세스 마스크를 지정합니다. RegOpenKeyEx 함수에서 허용하는 값 중 하나일 수 있습니다. 쓰기 액세스가 요청되면 조이스틱 구성을 먼저 획득해야 합니다. 읽기 액세스만 요청하면 취득이 필요하지 않습니다.

unnamedParam3

성공하면 열린 레지스트리 키를 가리킵니다.

반환 값

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

반환 코드 설명
DIERR_NOTACQUIRED
조이스틱 구성을 획득하지 못했습니다. 작성을 위해 조이스틱 형식 구성 키를 열려면 먼저 IDirectInputJoyConfig8::Acquire 를 호출해야 합니다.
DIERR_INVALIDPARAM
하나 이상의 매개 변수가 잘못되었습니다.
MAKE_HRESULT(SEVERITY_ERROR, FACILITY_WIN32, ErrorCode)
레지스트리 권한 또는 기타 외부 요인에 의해 키에 대한 액세스가 거부된 경우 Win32 오류 코드입니다.

설명

제어판 애플리케이션은 이 메서드에서 연 레지스트리 키를 사용하여 전역 구성 매개 변수와 같은 형식별 영구 정보를 저장할 수 있습니다. 이러한 개인 정보는 OEM이라는 하위 키에 보관해야 합니다. 기본 형식 키에 개인 정보를 저장하지 마세요. 제어판 애플리케이션은 이 키를 사용하여 디바이스 보정 프롬프트에 사용할 문자열과 같은 구성 정보를 읽을 수도 있습니다. 애플리케이션은 RegCloseKey 를 사용하여 레지스트리 키를 닫아야 합니다.

요구 사항

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