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 |