Função WdfDeviceIndicateWakeStatus (wdfdevice.h)

Artigo
02/07/2025

[Aplica-se somente ao KMDF]

O método WdfDeviceIndicateWakeStatus informa à estrutura que o motorista do ônibus de chamada parou de esperar que um dispositivo especificado disparasse um sinal de ativação no ônibus.

Sintaxe

NTSTATUS WdfDeviceIndicateWakeStatus(
  [in] WDFDEVICE Device,
  [in] NTSTATUS  WaitWakeStatus
);

Parâmetros

[in] Device

Um identificador para um objeto de dispositivo de estrutura.

[in] WaitWakeStatus

Um valor de status NTSTATUS. Se o dispositivo disparou um sinal de ativação, o chamador deverá definir esse valor como STATUS_SUCCESS ou outro valor de status para o qual NT_SUCCESS(WaitWakeStatus) é igual a VERDADEIRO. Se o dispositivo não disparou um sinal de ativação ou se um erro foi detectado, o chamador deve fornecer um valor de status para o qual NT_SUCCESS(WaitWakeStatus) é igual a FALSE. Para obter mais informações, consulte a seção Comentários a seguir.

Valor de retorno

Se a operação for bem-sucedida, WdfDeviceIndicateWakeStatus retornará STATUS_SUCCESS. Os valores de retorno adicionais incluem:

Código de retorno	Descrição
STATUS_INVALID_PARAMETER	WaitWakeStatus é STATUS_PENDING ou STATUS_CANCELLED.
STATUS_INVALID_DEVICE_REQUEST	A pilha de driver não foi configurada para aguardar o dispositivo disparar um sinal de ativação.
STATUS_INVALID_DEVICE_STATE	O driver de chamada não é responsável por esperar que o dispositivo dispare um sinal de ativação.

O método pode retornar outros valores NTSTATUS .

Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.

Observações

Se NT_SUCCESS(WaitWakeStatus) for igual a VERDADEIRO, a estrutura restaurará o dispositivo e o sistema para seus estados de trabalho. Se NT_SUCCESS(WaitWakeStatus) for igual a FALSE, o dispositivo e o sistema permanecerão em seus estados atuais.

Para obter mais informações sobre como chamar o método WdfDeviceIndicateWakeStatus, consulte suporte aode ativação do sistema.

Exemplos

O exemplo de código a seguir informa à estrutura que o dispositivo especificado disparou um sinal de ativação.

NTSTATUS  status;

status = WdfDeviceIndicateWakeStatus(
                                     hChild,
                                     STATUS_SUCCESS
                                     );

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
versão mínima do KMDF	1.0
cabeçalho	wdfdevice.h (inclua Wdf.h)
biblioteca	Wdf01000.sys (consulte o Controle de Versão da Biblioteca da Estrutura.)
IRQL	<= DISPATCH_LEVEL
regras de conformidade de DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Compartilhar via