信息
您所需的主题如下所示。但此主题未包含在此库中。

WdfPdoInitAssignContainerID 方法

The WdfPdoInitAssignContainerID method updates the container ID for a child device.

语法

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

参数

DeviceInit [in]

A pointer to a WDFDEVICE_INIT structure.

ContainerID [in]

A pointer to a UNICODE_STRING structure that contains a container ID string. The driver can allocate the string's buffer from paged pool.

返回值

If the operation succeeds, the method returns STATUS_SUCCESS. Additional return values include:

返回代码说明
STATUS_INVALID_DEVICE_REQUEST

The driver is initializing an FDO instead of a PDO.

STATUS_INSUFFICIENT_RESOURCES

The driver could not allocate space to store the container ID string.

 

The method might also return other NTSTATUS values.

评论

For more information about container IDs, see Device Identification Strings.

The driver must call WdfPdoInitAssignContainerID before calling WdfDeviceCreate. For more information about calling WdfDeviceCreate, see Creating a Framework Device Object.

示例

The following code example initializes a UNICODE_STRING structure, stores a Unicode string in the structure, and then registers the Unicode string as the device's container ID.

UNICODE_STRING containerId = {0}; 

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

要求

版本

Available in version 1.9 and later versions of KMDF.

标头

Wdfpdo.h (包括Wdf.h)

Wdf<MajorVersionNumber>000.sys (see Framework Library Versions.)

IRQL

PASSIVE_LEVEL

另请参见

RtlInitUnicodeString
WdfPdoInitAssignDeviceID
WdfPdoInitAssignInstanceID
WdfPdoInitAddHardwareID
WdfPdoInitAddCompatibleID

 

 

社区附加资源

显示:
© 2014 Microsoft