次の方法で共有

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
 WMI が指定された GUID の一意のインスタンス識別子を正常に指定したことを示します。
STATUS_UNSUCCESSFUL
 WMI サービスが使用できないことを示します。
STATUS_INSUFFICIENT_RESOURCES
 呼び出し元にインスタンス ID を提供するために十分なリソースが使用されなかったことを示します。

備考

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

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 以降で使用できます。
ターゲット プラットフォーム の 万国
ヘッダー wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
ライブラリ NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI コンプライアンス規則 を する HwStorPortProhibitedDDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm), SpNoWait(storport), StorPortStartIo(storport)

関連項目

IoWmiSuggestInstanceName