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.

Valor de retorno

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 .

Observações

Por padrão, o pai do novo objeto de estrutura geral é o objeto de driver da estrutura que o método WdfDriverCreate criou. Você pode usar o ParentObject membro 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 Usando objetos da Estrutura Geral.

Para obter mais informações sobre as regras de limpeza de uma hierarquia de objetos de estrutura, consulte Framework Object Life Cycle.

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

Consulte também

WDF_OBJECT_ATTRIBUTES

WDF_OBJECT_ATTRIBUTES_INIT

WdfDriverCreate

WdfObjectDelete