DXGKCB_EVAL_ACPI_METHOD回呼函式 (dispmprt.h)
DxgkCbEvalAcpiMethod 函式會評估顯示適配卡或顯示適配卡子裝置上指定的 ACPI 方法。
語法
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
)
{...}
參數
[in] DeviceHandle
表示顯示配接器的句柄。 顯示迷你埠驅動程式先前在傳遞 至 dxgkDdiStartDevice之 DXGKRNL_INTERFACE 結構的 DeviceHandle 成員中取得此句柄。
[in] DeviceUid
將評估方法之 ACPI 裝置的唯一標識碼。 如果 ACPI 裝置是顯示器適配卡的子系,這是 DXGK_CHILD_DESCRIPTOR 結構中顯示迷你埠驅動程式在 DxgkDdiQueryChildRelations期間填入的 ChildUid 成員。 如果 ACPI 裝置是顯示器配接器本身,則必須將此參數設定為 DISPLAY_ADAPTER_HW_ID。
[in] AcpiInputBuffer
ACPI_EVAL_INPUT_BUFFER_COMPLEX 結構的指標(定義於 Acpiioct.h中),由顯示迷你埠驅動程式配置並填入。 結構包含 ACPI 方法所需的自變數。 如需詳細資訊,請參閱下列一節。
[in] AcpiInputSize
AcpiInputBuffer 所指向之緩衝區的大小總計,以位元組為單位,。
[out] AcpiOutputBuffer
接收 ACPI 方法傳回值的ACPI_EVAL_OUTPUT_BUFFER結構指標(定義於 Acpiioct.h中)。 此參數可以是 NULL 。
[in] AcpiOutputSize
AcpiOutputBuffer 所指向之緩衝區的大小總計,以位元組為單位,。
傳回值
DxgkCbEvalAcpiMethod 如果成功,則會傳回STATUS_SUCCESS。 否則,它會傳回 Ntstatus.h中定義的其中一個錯誤碼。
言論
若要評估 ACPI 裝置上的 ACPI 方法,裝置本身必須位於 ACPI 命名空間中。 此外,顯示迷你埠驅動程序必須針對顯示迷你埠驅動程式向ACPI回報標識碼的任何 ACPI 子裝置設定 ChildUid 值較低的 16 位。
在傳回之前,DxgkCbEvalAcpiMethod 會將 ACPI_EVAL_INPUT_BUFFER_COMPLEX 結構 成員 Signature ACPI_EVAL_INPUT_BUFFER_COMPLEX_SIGNATURE。 在 Windows Vista Service Pack 1 (SP1)、Windows Server 2008 和更新版本的 Windows作系統中,如果顯示迷你埠驅動程式有子裝置,則它應該先將 [簽章] 設定為 [DXGK_ACPI_PASS_ARGS_TO_CHILDREN],再呼叫 DxgkCbEvalAcpiMethod。
例子
下列程式代碼範例示範如何評估 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);
}
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows Vista |
目標平臺 | 桌面 |
標頭 | dispmprt.h (包括 Dispmprt.h) |
IRQL | PASSIVE_LEVEL |