DXGKCB_EVAL_ACPI_METHOD funzione di callback (dispmprt.h)

Articolo
05/23/2024

La funzione DxgkCbEvalAcpiMethod valuta un metodo ACPI specificato in una scheda di visualizzazione o in un dispositivo figlio di una scheda di visualizzazione.

Sintassi

DXGKCB_EVAL_ACPI_METHOD DxgkcbEvalAcpiMethod;

NTSTATUS DxgkcbEvalAcpiMethod(
  [in]  HANDLE DeviceHandle,
  [in]  ULONG DeviceUid,
  [in]  PACPI_EVAL_INPUT_BUFFER_COMPLEX AcpiInputBuffer,
  [in]  ULONG AcpiInputSize,
  [out] PACPI_EVAL_OUTPUT_BUFFER AcpiOutputBuffer,
  [in]  ULONG AcpiOutputSize
)
{...}

Parametri

[in] DeviceHandle

Handle che rappresenta una scheda di visualizzazione. Il driver miniport visualizzato in precedenza ha ottenuto questo handle nel membro DeviceHandle della struttura DXGKRNL_INTERFACE passata a DxgkDdiStartDevice.

[in] DeviceUid

Identificatore univoco per il dispositivo ACPI in cui verrà valutato il metodo. Se il dispositivo ACPI è un elemento figlio dell'adattatore di visualizzazione, si tratta del membro ChildUid della struttura DXGK_CHILD_DESCRIPTOR che il driver miniport visualizzato compilato durante DxgkDdiQueryChildRelations. Se il dispositivo ACPI è la scheda di visualizzazione stessa, questo parametro deve essere impostato su DISPLAY_ADAPTER_HW_ID.

[in] AcpiInputBuffer

Puntatore a una struttura ACPI_EVAL_INPUT_BUFFER_COMPLEX (definita in Acpiioct.h) allocata e compilata dal driver miniport visualizzato. La struttura contiene gli argomenti richiesti dal metodo ACPI. Per altre informazioni, vedere la sezione Osservazioni seguenti.

[in] AcpiInputSize

Dimensioni totali, in byte, del buffer a cui punta acpiInputBuffer.

[out] AcpiOutputBuffer

Puntatore a una struttura ACPI_EVAL_OUTPUT_BUFFER (definita in Acpiioct.h) che riceve il valore restituito del metodo ACPI. Questo parametro può essere NULL.

[in] AcpiOutputSize

Dimensioni totali, in byte, del buffer a cui punta AcpiOutputBuffer.

Valore restituito

DxgkCbEvalAcpiMethod restituisce STATUS_SUCCESS se ha esito positivo. In caso contrario, restituisce uno dei codici di errore definiti in Ntstatus.h.

Commenti

Per valutare i metodi ACPI in un dispositivo ACPI, il dispositivo stesso deve trovarsi nello spazio dei nomi ACPI. Inoltre, il driver miniport visualizzato deve avere impostato i 16 bit inferiori del valore ChildUid per tutti i dispositivi figlio ACPI che il driver miniport visualizzato segnala all'identificatore segnalato da ACPI.

Prima di restituire, DxgkCbEvalAcpiMethod reimposta il membro Signature della struttura ACPI_EVAL_INPUT_BUFFER_COMPLEX in ACPI_EVAL_INPUT_BUFFER_COMPLEX_SIGNATURE. In Windows Vista con Service Pack 1 (SP1), Windows Server 2008 e versioni successive dei sistemi operativi Windows, se il driver miniport visualizzato ha dispositivi figlio, deve impostare Firma su DXGK_ACPI_PASS_ARGS_TO_CHILDREN prima di effettuare una chiamata a DxgkCbEvalAcpiMethod.

Nota Il sottosistema kernel grafico Microsoft DirectX non può valutare i metodi ACPI esterni allo spazio dei nomi del dispositivo.

Nota Visualizzare i driver miniport possono usare DxgkCbEvalAcpiMethod solo per schede grafiche a collegamento lead.

Esempio

Nell'esempio di codice seguente viene illustrato come valutare un metodo ACPI.

if (HwDeviceExtension->AcpiChildren != NULL) {
    ULONG ChildIndex;
    PACPI_METHOD_ARGUMENT AcpiChildrenArray = 
 &(((PACPI_EVAL_OUTPUT_BUFFER)HwDeviceExtension->AcpiChildren) 
   ->Argument[0]);
   ULONG ChildCount = ((PACPI_EVAL_OUTPUT_BUFFER) 
   (HwDeviceExtension->AcpiChildren))->Count;
  ULONG ChildUid;
  ACPI_EVAL_INPUT_BUFFER_COMPLEX AcpiInputBuffer = {'\0'};
   ACPI_EVAL_OUTPUT_BUFFER AcpiOutputBuffer;
    pDesiredStatus = ExAllocatePoolWithTag(PagedPool,
 sizeof(DESIRED_CHILD_STATUS) * ChildCount,
 ATI_TAG);

  if (pDesiredStatus == NULL) {
     Status = STATUS_NO_MEMORY;
        goto cleanup;
  }

 RtlZeroMemory(pDesiredStatus, sizeof(DESIRED_CHILD_STATUS) * ChildCount);

 for (ChildIndex = 0; ChildIndex < ChildCount; ChildIndex++) {
 // If not a video output child, go to the next child.
 if (AcpiChildrenArray[ChildIndex].Argument
   & ACPI_NON_VIDEO_OUTPUT_DEVICE) {
   continue;
      }
      // A video output child so the ChildUid is the VidPnTargetId.
       ChildUid = (AcpiChildrenArray[ChildIndex].Argument
   & ACPI_HARDWARE_ID) | HW_ID_DISPLAY_CHILD;

      // Query ACPI for the required state.
      //
  // Beginning with Windows Vista SP1 and Windows Server 2008,
  // use DXGK_ACPI_PASS_ARGS_TO_CHILDREN.

  #if (NTDDI_VERSION >= NTDDI_WIN6SP1)
   AcpiInputBuffer.Signature = 
   DXGK_ACPI_PASS_ARGS_TO_CHILDREN;
     #else
    AcpiInputBuffer.Signature = 
   ACPI_EVAL_INPUT_BUFFER_COMPLEX_SIGNATURE;
       #endif

     AcpiInputBuffer.MethodNameAsUlong = 
   ACPI_METHOD_OUTPUT_DGS;
     Status = DxgkCbEvalAcpiMethod(HwDeviceExtension->DeviceHandle,
         ChildUid,
         &AcpiInputBuffer,
         sizeof(ACPI_EVAL_INPUT_BUFFER_COMPLEX),
         &AcpiOutputBuffer,
         sizeof(ACPI_EVAL_OUTPUT_BUFFER));
     if (!NT_SUCCESS(Status)) {
         // Something really wrong
         goto cleanup;
     }
      // Determine what the new VidPn should be and
      // allow RecommendFunctionalVidPn to return it.
      // AcpiOutputBuffer.Argument[0].Argument == 1 indicates active
       // AcpiOutputBuffer.Argument[0].Argument == 0 
       // indicates not active
       pDesiredStatus[ChildIndex].bActive = 
   (AcpiOutputBuffer.Argument[0].Argument == 1) ? TRUE : FALSE;
      // Always use the first source because this is a keyboard shortcut.
      pDesiredStatus[ChildIndex].ulSourceId = 0;
      pDesiredStatus[ChildIndex].ulTargetId = ChildUid;
  }

 Status = InvalidateVidPnForHotKey(HwDeviceExtension, pDesiredStatus);
}