DBT_DEVICEARRIVAL イベント

  • [アーティクル]

システムは、デバイスまたはメディアの一部が挿入されて使用可能になったときに、DBT_DEVICEARRIVAL デバイス イベントをブロードキャストします。

このデバイス イベントをブロードキャストするために、システムは wParam が DBT_DEVICEARRIVAL に設定され、lParam が次のように設定されたWM_DEVICECHANGE メッセージを使用します。

LRESULT CALLBACK WindowProc(
  HWND hwnd,       // handle to window
  UINT uMsg,       // WM_DEVICECHANGE
  WPARAM wParam,   // device-change event
  LPARAM lParam    // event-specific data
);

パラメーター

hwnd

ウィンドウのハンドル。

uMsg

WM_DEVICECHANGE メッセージ識別子。

wParam

DBT_DEVICEARRIVALに設定します。

lParam

挿入されたデバイスを識別する構造体へのポインター。 構造体は、イベントに依存しないヘッダーの後に、デバイスを記述するイベントに依存するメンバーで構成されます。 この構造体を使用するには、構造体をDEV_BROADCAST_HDR構造体として扱い、そのdbch_devicetype メンバーをチェックしてデバイスの種類を決定します。

戻り値

TRUE を返します。

解説

メディアが挿入されている場合、到着するデバイスの種類はボリューム ( dbch_devicetype メンバーがDBT_DEVTYP_VOLUME) であり、変更によってメディアが影響を受けます ( dbcv_flags メンバーはDBTF_MEDIA)。

例

例については、「 メディアの挿入または削除の検出」を参照してください。

要件

要件 値
サポートされている最小のクライアント
 Windows XP
サポートされている最小のサーバー
 Windows Server 2003
ヘッダー
Dbt.h

関連項目

デバイス イベント

デバイス管理イベント

DEV_BROADCAST_HDR

WM_DEVICECHANGE