Função WdfSpinLockCreate (wdfsync.h)

[Aplica-se a KMDF e UMDF]

O método WdfSpinLockCreate cria um objeto de spin-lock de estrutura.

Sintaxe

NTSTATUS WdfSpinLockCreate(
  [in, optional] PWDF_OBJECT_ATTRIBUTES SpinLockAttributes,
  [out]          WDFSPINLOCK            *SpinLock
);

Parâmetros

[in, optional] SpinLockAttributes

Um ponteiro para uma estrutura de WDF_OBJECT_ATTRIBUTES alocada pelo chamador que especifica atributos para o objeto spin-lock. Esse parâmetro é opcional e pode ser WDF_NO_OBJECT_ATTRIBUTES.

[out] SpinLock

Um ponteiro para um local que recebe um identificador para um novo objeto de spin-lock da estrutura.

Retornar valor

WdfSpinLockCreate retornará STATUS_SUCCESS se a operação for bem-sucedida.

Para obter uma lista de outros valores retornados que o método WdfSpinLockCreate pode retornar, consulte Erros de criação de objeto da estrutura.

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

Comentários

O método WdfSpinLockCreate cria um objeto de spin-lock de estrutura. Depois de criar um objeto spin-lock, um driver pode chamar WdfSpinLockAcquire para adquirir o bloqueio e WdfSpinLockRelease para liberar o bloqueio.

Por padrão, o pai do novo objeto spin-lock é 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 spin-lock quando exclui o objeto pai. Se o driver não alterar o pai padrão, o driver deverá excluir o objeto spin-lock 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 bloqueios de rotação, consulte Técnicas de sincronização para drivers de Framework-Based.

Exemplos

O exemplo de código a seguir inicializa um WDF_OBJECT_ATTRIBUTES, especifica que o objeto pai do bloqueio de rotação será um objeto de dispositivo e chama WdfSpinLockCreate.

WDF_OBJECT_ATTRIBUTES attributes;
WDFSPINLOCK lockHandle;

WDF_OBJECT_ATTRIBUTES_INIT(&attributes);
attributes.ParentObject = Device;
status = WdfSpinLockCreate(
                           &attributes,
                           &lockHandle
                           );

Requisitos

Confira também

WDF_OBJECT_ATTRIBUTES

WdfDriverCreate

WdfSpinLockAcquire

WdfSpinLockRelease

Regra WdfSpinlock (KMDF)

Regra WdfSpinLockRelease (KMDF)