Função WdfPdoInitAssignContainerID (wdfpdo.h)

Artigo
02/27/2024

[Aplica-se somente ao KMDF]

O método WdfPdoInitAssignContainerID atualiza a ID do contêiner para um dispositivo filho.

Sintaxe

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

Parâmetros

[in] DeviceInit

Um ponteiro para uma estrutura WDFDEVICE_INIT .

[in] ContainerID

Um ponteiro para uma estrutura UNICODE_STRING que contém uma cadeia de caracteres de ID de contêiner. O driver pode alocar o buffer da cadeia de caracteres do pool de páginas.

Retornar valor

Se a operação for bem-sucedida, o método retornará STATUS_SUCCESS. Os valores retornados adicionais incluem:

Código de retorno	Descrição
STATUS_INVALID_DEVICE_REQUEST	O driver está inicializando um FDO em vez de um PDO.
STATUS_INSUFFICIENT_RESOURCES	O driver não pôde alocar espaço para armazenar a cadeia de caracteres de ID do contêiner.

O método também pode retornar outros valores NTSTATUS.

Comentários

Para obter mais informações sobre IDs de contêiner, consulte Cadeias de caracteres de identificação do dispositivo.

O driver deve chamar WdfPdoInitAssignContainerID antes de chamar WdfDeviceCreate. Para obter mais informações sobre como chamar WdfDeviceCreate, consulte Criando um objeto de dispositivo framework.

Exemplos

O exemplo de código a seguir inicializa uma estrutura de UNICODE_STRING , armazena uma cadeia de caracteres Unicode na estrutura e registra a cadeia de caracteres Unicode como a ID do contêiner do dispositivo.

UNICODE_STRING containerId = {0}; 

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

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Versão mínima do KMDF	1,9
Cabeçalho	wdfpdo.h (inclua Wdf.h)
Biblioteca	Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.)
IRQL	PASSIVE_LEVEL
Regras de conformidade de DDI	DriverCreate(kmdf)