IWMDMNotification

アプリケーションが任意で実装する IWMDMNotification インターフェースを使用すると、アプリケーションやサービスプロバイダーは、デバイスまたはメモリストレージ (RAM カードなど) がコンピューターに接続または切断されたときに通知を受け取ることができます。注: このメソッドは、登録済みのプラグアンドプレイ デバイスに対してのみ呼び出されます。それ以外のデバイスの接続や切断では、このインターフェースは呼び出されません。このインターフェースの GUID は mssachlp.lib で正しく定義されていないため、

WMDMMessage メソッドは、クライアントが実装するコールバック メソッドであり、プラグアンドプレイ対応のデバイスまたは記憶メディアが接続または取り外されたときに Windows Media Device Manager から呼び出されます。

戻り値は HRESULT であり、アプリケーションはメッセージの処理結果をこの値で返すことができます。ただし、戻り値は WMDM によって無視されます。

アプリケーションがこのメソッドを通じて通知を受け取るように登録する方法については、Enabling Notifications を参照してください。

例

次の C++ コードは WMDMMessage メソッドを実装し、デバイスまたはストレージの接続および切断の通知メッセージを出力します。

HRESULT WMDMMessage(DWORD  dwMessageType, LPCWSTR  pwszCanonicalName)
{
    switch(dwMessageType)
    {
    case WMDM_MSG_DEVICE_ARRIVAL:
        // TODO: 新しいデバイスが検出されたことを示すメッセージとデバイス名を表示します。
        break;
    case WMDM_MSG_DEVICE_REMOVAL:
        // TODO: デバイスが取り外されたことを示すメッセージとデバイス名を表示します。
        break;
    case WMDM_MSG_MEDIA_ARRIVAL:
        // TODO: デバイスに記憶メディアが追加されたことを示すメッセージとデバイス名を表示します。
        break;
    case WMDM_MSG_MEDIA_REMOVAL:
        // TODO: デバイスから記憶メディアが取り外されたことを示すメッセージとデバイス名を表示します。
        break;
    default:
        // TODO: 識別できないメッセージを受信したことを示すメッセージを表示します。
        break;
    }
    return S_OK; // 戻り値は無視され、アプリケーションには返されません。
}