Compartilhar via


Função AcxDeviceGetCurrentDxExitLatency (acxdevice.h)

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 estado de energia do dispositivo para o qual obter o valor de latência.

Retornar valor

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

Comentários

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 usar 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 as versões do ACX, consulte Visão geral da versão do ACX.

Requisitos

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

Confira também