Función WdfPdoInitAssignContainerID (wdfpdo.h)
[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 |
---|---|
|
El controlador está inicializando un FDO en lugar de un PDO. |
|
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) |