Função WdfWaitLockCreate (wdfsync.h)
[Aplica-se a KMDF e UMDF]
O método WdfWaitLockCreate cria um objeto de bloqueio de espera da estrutura.
Sintaxe
NTSTATUS WdfWaitLockCreate(
[in, optional] PWDF_OBJECT_ATTRIBUTES LockAttributes,
[out] WDFWAITLOCK *Lock
);
Parâmetros
[in, optional] LockAttributes
Um ponteiro para uma estrutura de WDF_OBJECT_ATTRIBUTES alocada pelo chamador que especifica atributos para o objeto de bloqueio de espera. Esse parâmetro é opcional e pode ser WDF_NO_OBJECT_ATTRIBUTES.
[out] Lock
Um ponteiro para um local que recebe um identificador para um novo objeto de bloqueio de espera da estrutura.
Retornar valor
WdfWaitLockCreate retornará STATUS_SUCCESS se a operação for bem-sucedida.
Para obter uma lista de outros valores retornados que o método WdfWaitLockCreate pode retornar, consulte Erros de criação de objeto de estrutura.
Esse método também pode retornar outros valores NTSTATUS.
Comentários
O método WdfWaitLockCreate cria um objeto de bloqueio de espera da estrutura. Depois de criar um objeto de bloqueio de espera, um driver pode chamar WdfWaitLockAcquire para adquirir o bloqueio e WdfWaitLockRelease para liberar o bloqueio.
Por padrão, o pai do novo objeto wait-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 wait-lock quando exclui o objeto pai. Se o driver não alterar o pai padrão, o driver deverá excluir o objeto wait-lock quando terminar de usar o objeto ; caso contrário, o objeto permanecerá até que o gerenciador de E/S descarregue o driver.
Para obter mais informações sobre bloqueios de espera, 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 espera será um objeto de dispositivo e chama WdfWaitLockCreate.
WDF_OBJECT_ATTRIBUTES attributes;
WDFWAITLOCK lockHandle;
WDF_OBJECT_ATTRIBUTES_INIT(&attributes);
attributes.ParentObject = Device;
status = WdfWaitLockCreate(
&attributes,
&lockHandle
);
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 | wdfsync.h (inclua Wdf.h) |
| Biblioteca | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| Regras de conformidade da DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), ParentObjectCheckLock(kmdf) |