Función WdfPdoInitAssignContainerID (wdfpdo.h)

Artículo
03/05/2024

[Solo se aplica a KMDF]

El método WdfPdoInitAssignContainerID actualiza el identificador de contenedor de un dispositivo secundario.

Sintaxis

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

Parámetros

[in] DeviceInit

Puntero a una estructura de WDFDEVICE_INIT .

[in] ContainerID

Puntero a una estructura de UNICODE_STRING que contiene una cadena de identificador de contenedor. El controlador puede asignar el búfer de la cadena desde el grupo paginado.

Valor devuelto

Si la operación se realiza correctamente, el método devuelve STATUS_SUCCESS. Entre los valores devueltos adicionales se incluyen:

Código devuelto	Descripción
STATUS_INVALID_DEVICE_REQUEST	El controlador está inicializando un FDO en lugar de un PDO.
STATUS_INSUFFICIENT_RESOURCES	El controlador no pudo asignar espacio para almacenar la cadena de identificador de contenedor.

El método también podría devolver otros valores NTSTATUS.

Comentarios

Para obtener más información sobre los identificadores de contenedor, consulte Cadenas de identificación de dispositivos.

El controlador debe llamar a WdfPdoInitAssignContainerID antes de llamar a WdfDeviceCreate. Para obtener más información sobre cómo llamar a WdfDeviceCreate, vea Creating a Framework Device Object.

Ejemplos

En el ejemplo de código siguiente se inicializa una estructura de UNICODE_STRING , se almacena una cadena Unicode en la estructura y, a continuación, se registra la cadena Unicode como identificador de contenedor del dispositivo.

UNICODE_STRING containerId = {0}; 

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

Requisitos

Requisito	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1,9
Encabezado	wdfpdo.h (incluya Wdf.h)
Library	Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos).
IRQL	PASSIVE_LEVEL
Reglas de cumplimiento de DDI	DriverCreate(kmdf)