IoWMISuggestInstanceName 関数 (wdm.h)

  • [アーティクル]

IoWMISuggestInstanceName ルーチンを使用して、ドライバーがデバイスの WMI インスタンス名を構築するために使用できるベース名を WMI が提案するように要求します。

構文

NTSTATUS IoWMISuggestInstanceName(
  [in, optional] PDEVICE_OBJECT  PhysicalDeviceObject,
  [in, optional] PUNICODE_STRING SymbolicLinkName,
  [in]           BOOLEAN         CombineNames,
  [out]          PUNICODE_STRING SuggestedInstanceName
);

パラメーター

[in, optional] PhysicalDeviceObject

指定した場合は、ドライバーの物理デバイス オブジェクトを指します。

[in, optional] SymbolicLinkName

指定した場合は、 IoRegisterDeviceInterface から返されるシンボリック リンク名を指します。

[in] CombineNames

TRUE の場合、返される推奨名は PhysicalDeviceObject と SymbolicLinkName 情報を組み合わせます。

[out] SuggestedInstanceName

正常に完了すると、推奨されるインスタンス名を含む UNICODE_STRING が含まれるバッファーへのポインター。 呼び出し元は、不要になったときにこのバッファーを解放する責任があります。

戻り値

IoWMISuggestInstanceName は、次の一覧から状態コードを返します。

リターン コード 説明
STATUS_SUCCESS
 WMI がこの関数を正常に完了できたことを示します。
STATUS_UNSUCCESSFUL
 WMI サービスが使用できないことを示します。
STATUS_INSUFFICIENT_RESOURCES
 Unicode 文字列を含むバッファーを呼び出し元に提供するために十分なリソースが使用できなかったことを示します。
STATUS_NO_MEMORY
 Unicode 文字列を含むバッファーを呼び出し元に提供するために十分なリソースが使用できなかったことを示します。

注釈

CombineNames パラメーターが TRUE の場合は、PhysicalDeviceObject と SymbolicLinkName の両方を指定する必要があります。 それ以外の場合は、そのうちの 1 つだけを指定する必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 2000 以降で使用できます。
対象プラットフォーム ユニバーサル
Header wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library NtosKrnl.lib
[DLL] NtosKrnl.exe
IRQL <= APC_LEVEL

こちらもご覧ください

IoWMIAllocateInstanceIds