WdfPdoInitAddCompatibleID 函式 (wdfpdo.h)

[僅適用於 KMDF]

WdfPdoInitAddCompatibleID 方法會將相容的標識碼新增至子裝置的相容標識符清單。

語法

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

參數

[in] DeviceInit

WDFDEVICE_INIT 結構的指標。

[in] CompatibleID

包含相容標識符字串 之UNICODE_STRING 結構的指標。 驅動程式可以從分頁集區配置字串的緩衝區。

傳回值

如果作業成功,方法會傳回STATUS_SUCCESS。 其他傳回值包括:

傳回碼 Description
STATUS_INVALID_DEVICE_REQUEST
驅動程式正在初始化 FDO,而不是 PDO。
STATUS_INSUFFICIENT_RESOURCES
驅動程式無法配置空間來儲存相容的標識符字串。
 

方法也可能傳回其他 NTSTATUS值

備註

驅動程式可以新增裝置的一或多個相容標識碼。 應該依序新增它們,從最符合到最差的相符專案。 架構會依新增的順序,將標識碼傳遞給 PnP 管理員。 如需相容標識碼的詳細資訊,請參閱 裝置識別字串安裝程式如何選取驅動程式

驅動程序必須先呼叫 WdfPdoInitAddCompatibleID ,才能呼叫 WdfDeviceCreate。 如需呼叫 WdfDeviceCreate 的詳細資訊,請參閱 建立 Framework 裝置物件

範例

下列程式代碼範例會報告 Toaster 範例驅動程式使用的相容識別碼。

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

status = WdfPdoInitAddCompatibleID(
                                   DeviceInit,
                                   &compatId
                                   );

規格需求

需求
目標平台 Universal
最小 KMDF 版本 1.0
標頭 wdfpdo.h (包含 Wdf.h)
程式庫 Wdf01000.sys (請參閱 Framework Library Versioning.)
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