ＰＩＣでＵＳＢを！（知識ゼロからのスタートです）
ＰＩＣ１８Ｆ１４Ｋ５０のＵＳＢ機能を１００％自前のソフトで制御する試みです。しかもアセンブラで！
当記事は２００９年１２月から「ＴＴＬでＣＰＵをつくろう！」というタイトルの もとにほとんど毎日連載をしてきたものを再編集したものです。 ２０１１．７．１０

前へ
次へ
目次へ戻る
ホームページトップへ戻る
☆Ｃ＋＋でＵＳＢ（ＨＩＤ）アクセスプログラムを作成

ＰＩＣ側のプログラムはＣ１８コンパイラを使わずＰＩＣアセンブラで作成しますが、パソコン側のＵＳＢ（ＨＩＤ）アクセスプログラムはＢｏｒｌａｎｄ　Ｃ＋＋コンパイラで作成します。
しかしこれがまた難物で悪戦苦闘の連続でありました。

［第４３回］

●「外部シンボル　…が未解決」

今回は、２ヶ月も前に書きました、［第４０回］からの懸案でありました、「外部シンボル　…が未解決」という意味不明のエラーがいよいよ、といいますか、やっと「解決」いたします。

わかっていらっしゃる方には、何てこともないようなエラーメッセージなのでしょうけれど、全然わかっていらっしゃらない私といたしましては、こういう意味不明のメッセージに直面すると、もうどこから手をつけていったらよいものか、途方に暮れてしまいます。

これが昔ですと、中区栄の丸善とか星野書店とかなどに足を運び（ああ。当地名古屋のお話です）、専門書のコーナーに入り浸りで片っ端から目次や索引をめくってまわる、ということになるのでありますが、今は有難い時代で、たいていのことはインターネットでけりがついてしまいます。

で、ネットで検索をして回りましたところ、なんとか見えてまいりました。
どうやら、この「未解決」というのは、そういう関数がみつからないよ、ということを意味しているらしいのですね。

うう。それなら、業界用語などをお使いにならないで、「みつからない」と直截におっしゃっていただきたいですう。
そんなわけのわからない業界用語をお使いになるものですから、パラメータがおかしいのか、とかまたＷｉｎｄｏｗｓのバージョンが違うのか、など悩まないでもよいところで悩んでしまって、何日も空費してしまうのでありますから…。

はなから、「みつからない」と言っていただければ、それはそれでいくらなんでもこれはおかしいぞ、ということで、それなりに調べ方もありますでしょうに。
だってｉｎｃｌｕｄｅしておりますヘッダーファイルを調べましたら、ちゃんと定義してあるじゃありませんか。

Hidsdi.hの前半部分を以下に示します。

/*++
Copyright (c) 1996    Microsoft Corporation
Module Name:
    HIDDLL.H
Abstract:
    This module contains the PUBLIC definitions for the
    code that implements the HID dll.
Environment:
    Kernel & user mode
Revision History:
    Aug-96 : created by Kenneth Ray
--*/
#ifndef _HIDSDI_H
#define _HIDSDI_H
#include <pshpack4.h>
//#include "wtypes.h"
//#include <windef.h>
//#include <win32.h>
//#include <basetyps.h>
typedef LONG NTSTATUS;
#include "hidusage.h"
#include "hidpi.h"
typedef struct _HIDD_CONFIGURATION {
    PVOID    cookie;
    ULONG    size;
    ULONG    RingBufferSize;
} HIDD_CONFIGURATION, *PHIDD_CONFIGURATION;
typedef struct _HIDD_ATTRIBUTES {
    ULONG   Size; // = sizeof (struct _HIDD_ATTRIBUTES)
    //
    // Vendor ids of this hid device
    //
    USHORT  VendorID;
    USHORT  ProductID;
    USHORT  VersionNumber;
    //
    // Additional fields will be added to the end of this structure.
    //
} HIDD_ATTRIBUTES, *PHIDD_ATTRIBUTES;
BOOLEAN __stdcall
HidD_GetAttributes (
    IN  HANDLE              HidDeviceObject,
    OUT PHIDD_ATTRIBUTES    Attributes
    );
/*++
Routine Description:
    Fill in the given HIDD_ATTRIBUTES structure with the attributes of the
    given hid device.
--*/
void __stdcall
HidD_GetHidGuid (
   OUT   LPGUID   HidGuid
   );

ほうらね。
ＨｉｄＤ＿ＧｅｔＨｉｄＧｕｉｄもＨｉｄＤ＿ＧｅｔＡｔｔｒｉｂｕｔｅｓもちゃんとあるじゃありませんか。
そうすると、これでも「みつからない」というからには、これは相当におかしい何かがあるに違いない、ということになります。

ということで、さらに追求を続けた結果、やっとのことで正解にたどりつきました。

●Ｃ＋＋とＣの違いが関係しているらしい

どうやらこれは、”Ｃ＋＋”と”Ｃ”の「名前の解決」の違いが関係している、のだそうです。

それならそうと言ってくださいよお。
ますますＣの眷属全てが嫌いになってしまうじゃありませんかあ。

つまるところ、どういういきさつかはわかりませんが、このＨｉｄｓｄｉ．ｈなるものが、Ｃ＋＋ではなくて、Ｃで記述されているらしいのでありますね（あるいは、Ｈｉｄｐｉ．ｈも、か？）。

なんでもＣでの関数名とＣ＋＋の関数名は、ソースプログラムでは同じに見えていても、コンパイルすると違うものになってしまうのだそうで…（うむむ。なんともややこしい）。

で、もともとＣで書かれたソースプログラム（ヘッダーファイル）をＣ＋＋で書かれたプログラムと一緒にＣ＋＋でコンパイルすると、そのヘッダーファイルの先にあるはずの、ライブラリファイル（ＤＬＬの情報がある）との間で名前の整合性がなくなってしまって、そんな関数名はみつからないよ、というエラーメッセージになってしまう、ということのようであります。

じゃあ、その始末はいったいどうしてくれるのか、といいますと、そこで登場しますのが、ｅｘｔｅｒｎ　”Ｃ”です。

●ｅｘｔｅｒｎ　”Ｃ”

これもなんだかよくわからないものなのでありますが、これを”Ｃ”で書かれた関数名の前につけておきますと、そのところはＣ＋＋コンパイラが、”Ｃ＋＋”の名前ルールではなくて、”Ｃ”の名前ルールでコンパイルしてくれるのだそうです。

むむむ。よくはわからないのですけれど、やってみなけりゃあしょうがないのでありますから、とりあえず、Ｈｉｄｓｄｉ．ｈの、

void __stdcall HidD_GetHidGuid (

のところを、

extern "C" void __stdcall HidD_GetHidGuid (

のように直して、コンパイルしてみました。
そうしましたら。



おお。
そのようにＨｉｄｓｄｉ．ｈを直す前は、
Ｅｒｒｏｒ：外部シンボル…
というのが２つ表示されていたところが、直したあとでは、エラーが１つになりました。

画面の真中から下のあたりで実行しているコンパイルでは、
ＨｉｄＤ＿ＧｅｔＨｉｄＧｕｉｄ（　
の前にｅｘｔｅｒｎ　”Ｃ”を追加した、Ｈｉｄｓｄｉ．ｈを作業中のフォルダに置いたあとでコンパイルしています。
ＨｉｄＤ＿ＧｅｔＨｉｄＧｕｉｄ（　については、エラーが出なくなりました。

これで、やっと「解決」です。
Ｈｉｄｓｄｉ．ｈに定義されている全ての関数の前に
ｅｘｔｅｒｎ　”Ｃ”
をつければ、この問題は解決いたします。
やっとのことで、めでたし、めでたし、です。

しかし。
それはそれでよいのですけれど、全ての関数の前にｅｘｔｅｒｎ　”Ｃ”をつける、というところが、
うむむ。
少しばかり面白くないなあ、という気がします。

で、もう少し調べてみましたら、こういう書き方もできることがわかりました。

（これより前の部分省略）
Revision History:
    Aug-96 : created by Kenneth Ray
--*/

#ifdef __cplusplus
extern "C" {
#endif

#ifndef _HIDSDI_H
#define _HIDSDI_H

（この間省略）

#ifdef __cplusplus
}
#endif

Ｈｉｄｓｄｉ．ｈのはじめの部分に、
#ifdef __cplusplus
extern "C" {
#endif
を書き加えて、終わりの部分に、
#ifdef __cplusplus
}
#endif
を書き加えます。

これこれ。
この方が、なんだかかっこいいように見えますねえ。

cplusplus　ってなんじゃいなあ、と思ったのですけれど、
そうか、Ｃ　ｐｌｕｓ　ｐｌｕｓ（Ｃ＋＋）のことだったのですね。

つまり、もしＣ＋＋でコンパイルするならば、このソースプログラムの、その位置に
ｅｘｔｅｒｎ　”Ｃ”　｛
を置いて、そしてソースプログラムの最後のところにも、もしＣ＋＋でコンパイルするならば、最後のその位置に
｝
を置きますよ、ということです。

Ｈｉｄｓｄｉ．ｈにそのようにして書き加えたものをＨｉｄｓｄｉ２．ｈとして作業中のフォルダに置き、そしてテストプログラムＨｉｄｔｅｓｔ１＿８＿ｄ．ｃｐｐの、
#include "hidsdi.h"
を
#include "hidsdi2.h"
に直してから、コンパイルしてみました。

おお。エラーは出なくなりました。

うう。
しかし。

最初は、ちょいとかっこいい、と思った、
#ifdef __cplusplus
ですけれど、よくよく考えてみると、それもなんだか回りくどいのではないですかあ。

「もしも」、も何も、私ははじめからＣ＋＋を使うつもりなので、そのほかの言語を使うつもりはさらさらありませんから、この　#ｉｆｄｅｆ __cplusplus　は全く余計な気がします。

それならば、いっそ、こんな具合にできませんかねえ。

Ｈｉｄｓｄｉ．ｈはもとの最初のままのものを使うことにしまして、ＨＩＤテストプログラムの、

#include "hidsdi.h"

のところを、

extern "C" {
#include "hidsdi.h"
}

にしてみました。

ＨＩＤテストプログラムのソースリストは［第３９回］にあります（そのリストでは、#include "hidsdi2.h"　になっています）。

これをＨｉｄｔｅｓｔ１＿８＿ｅ．ｃｐｐという名前にしたうえで、コンパイルしてみました。


おお。どうやらエラーにならずにうまく通ったようです。
これなら、文句無し、です。
めでたし、めでたし、でした。
ＣＰＵをつくろう！第４７０回（２０１０．４．５ｕｐｌｏａｄ）を再編集

ＰＩＣでＵＳＢを！［第４３回］
２０１１．７．１０ｕｐｌｏａｄ

前へ
次へ
目次へ戻る
ホームページトップへ戻る