WdfPdoInitAssignContainerID 函式 (wdfpdo.h)

發行項
02/27/2024

[僅適用於 KMDF]

WdfPdoInitAssignContainerID 方法會更新子裝置的容器標識碼。

語法

NTSTATUS WdfPdoInitAssignContainerID(
  [in] PWDFDEVICE_INIT  DeviceInit,
  [in] PCUNICODE_STRING ContainerID
);

參數

[in] DeviceInit

WDFDEVICE_INIT 結構的指標。

[in] ContainerID

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

傳回值

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

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

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

備註

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

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

範例

下列程式代碼範例會初始化 UNICODE_STRING 結構、將 Unicode 字串儲存在結構中，然後將 Unicode 字串註冊為裝置的容器識別碼。

UNICODE_STRING containerId = {0}; 

RtlInitUnicodeString(
                     &containerId,
                     strContainerId //Unicode string for container ID
                     );
status = WdfPdoInitAssignContainerID(
                                     pDeviceInit,
                                     &containerId
                                     );

規格需求

需求	值
目標平台	Universal
最小 KMDF 版本	1.9
標頭	wdfpdo.h (包含 Wdf.h)
程式庫	Wdf01000.sys (請參閱 Framework Library Versioning.)
IRQL	PASSIVE_LEVEL
DDI 合規性規則	DriverCreate (kmdf)