Função AcxDeviceGetCurrentDxExitLatency (acxdevice.h)

Artigo
02/06/2025

A função AcxDeviceGetCurrentDxExitLatency obtém o valor de latência de saída do estado de suspensão do dispositivo de áudio atual.

Sintaxe

ACX_DX_EXIT_LATENCY AcxDeviceGetCurrentDxExitLatency(
  WDFDEVICE              Device,
  POWER_ACTION           SystemPowerAction,
  WDF_POWER_DEVICE_STATE DeviceState
);

Parâmetros

Device

Ponteiro para o WDFDEVICE para o qual obter a latência de saída.

SystemPowerAction

A ação de energia do sistema para a qual obter o valor de latência.

DeviceState

O dispositivo o estado de energia para o qual obter o valor de latência.

Valor de retorno

AcxDeviceGetCurrentDxExitLatency retorna o valor de latência de saída do dispositivo atual, conforme definido na enumeração ACX_DX_EXIT_LATENCY.

Observações

Um dispositivo tem estados de energia diferentes. O estado de energia D0 é quando o dispositivo está em funcionamento, D1 é quando o dispositivo é um dos estados de suspensão e assim por diante. "Dx" refere-se a qualquer estado de suspensão do dispositivo.

Os drivers de áudio sabem quando entrar D3Hot ou D3Cold com base no ACX_DX_EXIT_LATENCY retornado por esse método.

Exemplo

WDFDEVICE              Device;
WDF_POWER_DEVICE_STATE TargetState;
ACX_DX_EXIT_LATENCY    latency;
POWER_ACTION           powerAction;

// Code to initialize WDFDEVICE and WDF_POWER_DEVICE_STATE...

powerAction = WdfDeviceGetSystemPowerAction(Device);

//
// Get the current exit latency.
//
latency = AcxDeviceGetCurrentDxExitLatency(Device, powerAction, TargetState);

Requisitos do ACX

versão mínima do ACX: 1.0

Para obter mais informações sobre versões do ACX, consulte visão geral da versão do ACX.

Requisitos

Requisito	Valor
cabeçalho	acxdevice.h
IRQL	<= DISPATCH_LEVEL

Partilhar via