DXGKDDI_PROTECTED_CALLBACK回呼函式 (dispmprt.h)

DxgkProtectedCallback 回呼例程是由顯示迷你埠驅動程序實作，並在防止所有存取顯示配接器時，由 DxgkCbExcludeAdapterAccess 呼叫。

語法

DXGKDDI_PROTECTED_CALLBACK DxgkddiProtectedCallback;

void DxgkddiProtectedCallback(
  [in] IN_CONST_PVOID MiniportDeviceContext,
  [in] PVOID ProtectedCallbackContext,
  [in] NTSTATUS ProtectionStatus
)
{...}

參數

[in] MiniportDeviceContext

與顯示配接器相關聯的內容區塊句柄。 顯示迷你埠驅動程式的 DxgkDdiAddDevice 函式先前已將此句柄提供給 DirectX 圖形核心子系統。

[in] ProtectedCallbackContext

在先前呼叫 DxgkCbExcludeAdapterAccess 中指定的驅動程式定義資訊的指標。

[in] ProtectionStatus

顯示配接器受保護狀態的狀態。 如果STATUS_SUCCESS，配接器已成功受到存取保護。 失敗狀態代碼表示配接器未受到保護。

傳回值

無

備註

只有在顯示適配卡的所有存取已停止時，才必須呼叫 DxgkProtectedCallback，如狀態參數 ProtectionStatus 所示。

驅動程式必須確保在回呼例程期間符合下列條件：

• 裝置上的所有中斷都會停用，而且會處理任何剩餘的擱置中斷，包括可能已排入任何 CPU 但尚未服務的任何 DPC。
• 所有寫入合併的記憶體和任何其他快取相關狀態都已排清。
• 發生的任何 ACPI 或 BIOS/SMI 事件都不會存取硬體。
• 連結配接器狀態設定中的所有適配卡之間都會達到共合。
• 配接器，包括其緩存器和顯示模式，會維持在適當的狀態，以處理從 DxgkProtectedCallback 例程傳回時發生的 DMA 緩衝區。 驅動程式不應該變更任何應用程式的可見狀態或功能。

規格需求

另請參閱

DxgkCbExcludeAdapterAccess