IDirectInputJoyConfig8::Acquire メソッド (dinputd.h)

  • [アーティクル]

IDirectInputJoyConfig8::Acquire メソッドは、"ジョイスティック構成モード" を取得します。一度にジョイスティック構成モードにできるアプリケーションは 1 つだけです。このモードを取得するために他のアプリケーションによる後続の試行は、エラー DIERR_OTHERAPPHASPRIOを受け取る必要があります。 構成モードに入った後、アプリケーションはグローバルジョイスティックの構成設定を変更できます。 別のアプリケーションが暫定的に設定を変更した場合に備えて、新しい設定をインストールする前に、アプリケーションで既存の設定をチェックする必要があります。

構文

HRESULT Acquire();

戻り値

成功した場合はDI_OKを返します。それ以外の場合は、次のいずれかの COM エラー値を返します。

リターン コード 説明
DIERR_OTHERAPPHASPRIO
もう 1 つのアプリケーションは、既にジョイスティック構成モードです。
DIERR_INSUFFICIENTPRIVS
現在のユーザーには、ジョイスティックの構成を変更するために必要なアクセス許可がありません。
DIERR_DEVICECHANGE
別のアプリケーションがグローバルジョイスティックの構成を変更しました。 インターフェイスを再初期化する必要があります。

要件

要件 値
対象プラットフォーム デスクトップ
Header dinputd.h (Dinputd.h を含む)