Função WdfDeviceIndicateWakeStatus (wdfdevice.h)

  • Artigo

[Aplica-se somente ao KMDF]

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

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 deve definir esse valor como STATUS_SUCCESS ou outro valor status para o qual NT_SUCCESS(WaitWakeStatus) é igual a TRUE. Se o dispositivo não disparou um sinal de ativação ou se um erro foi detectado, o chamador deve fornecer um valor status para o qual NT_SUCCESS(WaitWakeStatus) é igual a FALSE. Para obter mais informações, consulte a seção Comentários a seguir.

Retornar valor

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.

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Comentários

Se NT_SUCCESS(WaitWakeStatus) for igual a TRUE, 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 Supporting System Wake-Up.

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
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Cabeçalho wdfdevice.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.)
IRQL <= DISPATCH_LEVEL
Regras de conformidade da DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)