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 を呼び出して、デバイス インスタンスの状態と問題コードを確認します。

要件

関連項目

CM_Get_DevNode_Status

CM_Get_DevNode_Status_Ex

CM_Query_And_Remove_SubTree

CM_Query_And_Remove_SubTree_Ex

DIF_PROPERTYCHANGE