AcxDeviceGetCurrentDxExitLatency-Funktion (acxdevice.h)

  • Artikel

Die AcxDeviceGetCurrentDxExitLatency-Funktion ruft den aktuellen Wert für den Standbyzustand des Audiogeräts ab.

Syntax

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

Parameter

Device

Zeiger auf den WDFDEVICE , für den die Exitlatenz abgerufen werden soll.

SystemPowerAction

Die Systemleistungsaktion , für die der Latenzwert abgerufen werden soll.

DeviceState

Der Energiezustand des Geräts, für den der Latenzwert abgerufen werden soll.

Rückgabewert

AcxDeviceGetCurrentDxExitLatency gibt den aktuellen Wert für die Geräteausgangslatenz zurück, wie in der ACX_DX_EXIT_LATENCY-Enumeration definiert.

Hinweise

Ein Gerät verfügt über andere Energiezustände. Der D0-Energiezustand ist, wenn das Gerät aktiv ist und ausgeführt wird, D1 ist, wenn das Gerät einer der Standbyzustände ist usw. "Dx" bezieht sich auf jeden Gerätemoduszustand.

Audiotreiber wissen basierend auf den von dieser Methode zurückgegebenen ACX_DX_EXIT_LATENCY, wann sie in D3Hot oder D3Cold verwendet werden sollen.

Beispiel

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);

ACX-Anforderungen

ACX-Mindestversion: 1.0

Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.

Anforderungen

Anforderung Wert
Header acxdevice.h
IRQL <= DISPATCH_LEVEL

Weitere Informationen