WdfPdoInitAssignInstanceID 函式 (wdfpdo.h)

  • 發行項

[僅適用於 KMDF]

WdfPdoInitAssignInstanceID 方法會更新子裝置的實例標識碼。

語法

NTSTATUS WdfPdoInitAssignInstanceID(
  [in] PWDFDEVICE_INIT  DeviceInit,
  [in] PCUNICODE_STRING InstanceID
);

參數

[in] DeviceInit

WDFDEVICE_INIT 結構的指標。

[in] InstanceID

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

傳回值

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

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

方法也可能傳回其他 NTSTATUS值。

備註

如需實例標識碼的詳細資訊，請參閱 裝置識別字串。

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

範例

下列程式代碼範例會將裝置的序號轉換成 Unicode 字串，然後將 Unicode 字串註冊為裝置的實例識別碼。

DECLARE_UNICODE_STRING_SIZE(instanceID, INSTANCEID_LENGTH);

status =  RtlIntegerToUnicodeString(
                                    SerialNo,
                                    BASE_DEC,
                                    &instanceID
                                    );
status = WdfPdoInitAssignInstanceID(
                                    pDeviceInit,
                                    &instanceID
                                    );

規格需求

需求 值
目標平台 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)

另請參閱

RtlIntegerToUnicodeString

WdfPdoInitAddCompatibleID

WdfPdoInitAddHardwareID

WdfPdoInitAssignDeviceID