CM_Setup_DevNode関数 (cfgmgr32.h)
CM_Setup_DevNode関数は、デバイス構成に問題があるため、実行されていないデバイス インスタンスを再起動します。
構文
CMAPI CONFIGRET CM_Setup_DevNode(
[in] DEVINST dnDevInst,
[in] ULONG ulFlags
);
パラメーター
[in] dnDevInst
ローカル システムにバインドされているデバイス インスタンス ハンドル。
[in] ulFlags
次のいずれかのフラグ値:
CM_SETUP_DEVNODE_READY
デバイス構成に問題があるため、実行されていないデバイス インスタンスを再起動します。
CM_SETUP_DEVNODE_RESET (Windows XP 以降のバージョンの Windows)
再起動デバイスの状態フラグが設定されていないデバイス インスタンスをリセットします。 CM_Query_And_Remove_SubTreeまたはCM_Query_And_Remove_SubTree_Exを呼び出し、CM_REMOVE_NO_RESTART フラグを指定してデバイスが削除された場合、再起動デバイスの状態フラグは設定されません。
戻り値
操作が成功した場合、関数はCR_SUCCESSを返します。 それ以外の場合は、 Cfgmgr32.h で定義されている "CR_" プレフィックスを持つエラー コードのいずれかを返します。
解説
デバイス インストール アプリケーションでは、 この関数を使用するのではなく、 DIF_PROPERTYCHANGE 要求を使用してデバイスを再起動する必要があります。 DIF_PROPERTYCHANGE要求は、デバイスのプロパティを有効、無効、再起動、停止、または変更するために使用できます。
デバイス インスタンスに問題がなく、既に開始されている場合、 CM_Setup_DevNode はデバイス インスタンスの状態を変更せずに を返します。
CM_Get_DevNode_Status または CM_Get_DevNode_Status_Ex を呼び出して、デバイス インスタンスの状態と問題コードを確認します。
要件
| サポートされている最小のクライアント | Microsoft Windows 2000 以降のバージョンの Windows で使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | cfgmgr32.h (Cfgmgr32.h を含む) |
| Library | Cfgmgr32.lib;Windows 10の OneCoreUAP.lib |
| [DLL] | CfgMgr32.dll |