Função WdfObjectCreate (wdfobject.h)

[Aplica-se a KMDF e UMDF]

O método WdfObjectCreate cria um objeto de estrutura geral.

Sintaxe

NTSTATUS WdfObjectCreate(
  [in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
  [out]          WDFOBJECT              *Object
);

Parâmetros

[in, optional] Attributes

Um ponteiro para uma estrutura WDF_OBJECT_ATTRIBUTES que contém atributos fornecidos pelo driver para o novo objeto. Esse parâmetro é opcional e pode ser WDF_NO_OBJECT_ATTRIBUTES.

[out] Object

Um ponteiro para um local que recebe um identificador para o novo objeto de estrutura.

Retornar valor

WdfObjectCreate retornará STATUS_SUCCESS se a operação for bem-sucedida. Para obter uma lista de valores retornados adicionais, consulte Erros de criação de objeto da estrutura.

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

Comentários

Por padrão, o pai do novo objeto de estrutura geral é o objeto de driver de estrutura que o método WdfDriverCreate criou. Você pode usar o membro ParentObject da estrutura WDF_OBJECT_ATTRIBUTES para especificar um pai diferente. A estrutura exclui o objeto geral quando exclui o objeto pai. Se o driver não alterar o pai padrão, o driver deverá excluir o objeto geral quando terminar de usar o objeto ; caso contrário, o objeto permanecerá até que o gerente de E/S descarregue o driver.

Para obter mais informações sobre o método WdfObjectCreate , consulte Using General Framework Objects (Usando objetos do General Framework).

Para obter mais informações sobre as regras de limpeza de uma hierarquia de objetos de estrutura, consulte Ciclo de Vida do Objeto framework.

Exemplos

O exemplo de código a seguir inicializa uma estrutura WDF_OBJECT_ATTRIBUTES e cria um objeto de estrutura geral.

WDF_OBJECT_ATTRIBUTES  Attributes;
WDFOBJECT  Object;

WDF_OBJECT_ATTRIBUTES_INIT(&Attributes);
status = WdfObjectCreate(
                         &Attributes,
                         &Object
                         );

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Versão mínima do KMDF	1.0
Versão mínima do UMDF	2,0
Cabeçalho	wdfobject.h (inclua Wdf.h)
Biblioteca	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
Regras de conformidade de DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Confira também

WDF_OBJECT_ATTRIBUTES

WDF_OBJECT_ATTRIBUTES_INIT

WdfDriverCreate

WdfObjectDelete