IoWMIAllocateInstanceIds 関数 (wdm.h)

  • [アーティクル]

IoWMIAllocateInstanceIds ルーチンは、GUID に固有の 1 つ以上のインスタンス ID を割り当てます。

構文

NTSTATUS IoWMIAllocateInstanceIds(
  [in]  LPCGUID Guid,
  [in]  ULONG   InstanceCount,
  [out] ULONG   *FirstInstanceId
);

パラメーター

[in] Guid

インスタンス識別子を生成する GUID へのポインター。

[in] InstanceCount

指定する必要があるインスタンス識別子の数を指定します。

[out] FirstInstanceId

ドライバーが使用する最初のインスタンス識別子へのポインター。

戻り値

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

リターン コード 説明
STATUS_SUCCESS
 指定された GUID の一意のインスタンス識別子が WMI によって正常に指定されたことを示します。
STATUS_UNSUCCESSFUL
 WMI サービスが使用できないことを示します。
STATUS_INSUFFICIENT_RESOURCES
 呼び出し元にインスタンス ID を提供するために十分なリソースが使用できなかったことを示します。

注釈

InstanceCount で複数のインスタンスが要求され、ルーチンが正常に完了した場合、FirstInstanceId は呼び出し元が使用する最初のインスタンスを指します。 1 を超えて要求されたインスタンスごとに、呼び出し元は *FirstInstanceId で返される値をインクリメントする必要があります。 たとえば、呼び出し元が 6 つのインスタンスを要求し、1 つが FirstInstanceId の値として返された場合、呼び出し元は一意のインスタンス識別子として値 1 から 6 を使用する必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 2000 以降で使用できます。
対象プラットフォーム ユニバーサル
Header wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library NtosKrnl.lib
[DLL] NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI コンプライアンス規則 HwStorPortProhibitedDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm), SpNoWait(storport), StorPortStartIo(storport)

こちらもご覧ください

IoWmiSuggestInstanceName