WdfPdoInitAddCompatibleID 関数 (wdfpdo.h)

[KMDF にのみ適用]

WdfPdoInitAddCompatibleID メソッドは、子デバイスの互換性のある ID の一覧に互換性のある ID を追加します。

構文

NTSTATUS WdfPdoInitAddCompatibleID(
  [in] PWDFDEVICE_INIT  DeviceInit,
  [in] PCUNICODE_STRING CompatibleID
);

パラメーター

[in] DeviceInit

WDFDEVICE_INIT 構造体へのポインター。

[in] CompatibleID

互換性のある ID 文字列を含む UNICODE_STRING 構造体へのポインター。 ドライバーは、ページングされたプールから文字列のバッファーを割り当てることができます。

戻り値

操作が成功した場合、メソッドはSTATUS_SUCCESSを返します。 その他の戻り値は次のとおりです。

リターン コード 説明
STATUS_INVALID_DEVICE_REQUEST
 ドライバーが PDO ではなく FDO を初期化しています。
STATUS_INSUFFICIENT_RESOURCES
 ドライバーは、互換性のある ID 文字列を格納する領域を割り当てませんでした。
 

このメソッドは、他の NTSTATUS 値返す場合もあります。

注釈

ドライバーは、デバイスに 1 つ以上の互換性のある ID を追加できます。 ベストマッチから最悪の試合まで順番に追加する必要があります。 フレームワークは、追加された順序で PnP マネージャーに ID を配信します。 互換性のある ID の詳細については、「デバイス識別文字列の と セットアップでドライバーを選択する方法」を参照してください。

ドライバーは、WdfDeviceCreate 呼び出す前に、WdfPdoInitAddCompatibleID を呼び出す必要があります。 WdfDeviceCreate 呼び出す方法の詳細については、「フレームワーク デバイス オブジェクトの作成」を参照してください。

例示

次のコード例では、トースター サンプル ドライバーが使用する互換性のある ID 値を報告します。

DECLARE_CONST_UNICODE_STRING(compatId, L"{B85B7C50-6A01-11d2-B841-00C04FAD5171}\\MsCompatibleToaster\0");

status = WdfPdoInitAddCompatibleID(
                                   DeviceInit,
                                   &compatId
                                   );

必要条件

要件 価値
ターゲット プラットフォーム の 普遍
最小 KMDF バージョン 1.0
ヘッダー wdfpdo.h (Wdf.h を含む)
図書館 Wdf01000.sys (フレームワーク ライブラリのバージョン管理を参照)。
IRQL PASSIVE_LEVEL
DDI コンプライアンス規則 を する ChildDeviceInitAPI(kmdf), DriverCreate(kmdf), InitFreeDeviceCallback(kmdf), InitFreeDeviceCreate(kmdf), InitFreeNull(kmdf), KmdfIrql (kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf), PdoInitFreeDeviceCallback(kmdf), PdoInitFreeDeviceCreate(kmdf)

こちらもご覧ください

WdfPdoInitAddHardwareID の

WdfPdoInitAssignDeviceID の

WdfPdoInitAssignInstanceID

  • Last updated on