DXGKDDI_ADD_DEVICE回呼函式 (dispmprt.h)

  • 發行項

DxgkDdiAddDevice 函式會建立顯示配接器的內容區塊，並傳回代表顯示適配卡的句柄。

語法

DXGKDDI_ADD_DEVICE DxgkddiAddDevice;

NTSTATUS DxgkddiAddDevice(
  [in]  IN_CONST_PDEVICE_OBJECT PhysicalDeviceObject,
  [out] OUT_PPVOID MiniportDeviceContext
)
{...}

參數

[in] PhysicalDeviceObject

識別顯示適配卡的實體裝置物件指標 (PDO) 。

[out] MiniportDeviceContext

接收由顯示迷你埠驅動程式所建立句柄之變數的指標，代表 PhysicalDeviceObject 所識別的顯示配接器。 顯示迷你埠驅動程式可以在此參數中傳回 NULL，指出它不支援 PhysicalDeviceObject 所識別的顯示適配卡。

傳回值

DxgkDdiAddDevice 如果成功，則會傳回STATUS_SUCCESS;否則，它會傳回 Ntstatus.h 中定義的其中一個錯誤碼。

備註

DxgkDdiAddDevice 函式會配置與 PhysicalDeviceObject 所識別之顯示配接器相關聯的私人內容區塊。 您可以將 MiniportDeviceContext 中傳回的句柄視為顯示適配卡的句柄，或當做與顯示配接器相關聯之內容區塊的句柄。 DirectX 圖形核心子系統 (Dxgkrnl.sys) 會在顯示迷你埠驅動程序的後續呼叫中提供句柄。 下列清單提供各種元件範例 ，這些元件Dxgkrnl.sys 將句柄傳遞至顯示迷你埠驅動程式所實作的函式。

請勿混淆有時句柄的名稱為 MiniportDeviceContext ，有時也稱為 hAdapter。 此外，請勿將此句柄與傳遞至特定顯示迷你埠驅動程式函式 的 hDevice 參數混淆。

DxgkDdiAddDevice 會在序列中一次針對一部裝置叫用。 其行為與 WDM 核心模式驅動程式的標準 DRIVER_ADD_DEVICE 回呼相同。

有些顯示器適配卡有兩個以上的PCI函式，可扮演顯示配卡的角色。 例如，某些較舊的卡片會為每個檢視使用不同的PCI函式來實作多個檢視。 顯示埠驅動程式會針對每一個PCI函式呼叫 DxgkDdiAddDevice 一次，此時顯示迷你埠驅動程式可以透過將 MiniportDeviceContext 設定為非零值) ，或將 MiniportDeviceContext 設定為 NULL) ，以指出它支援 (PCI 函式 (。 若要取得特定PCI函式的相關信息，顯示迷你埠驅動程式可以將 PhysicalDeviceObject 傳遞至 IoGetDeviceProperty。

在 DxgkDdiRemoveDevice 中，釋出內容區塊，以及您在 DxgkDdiAddDevice 期間配置的任何其他資源。

應該將 DxgkDdiAddDevice 函式設為可分頁。

規格需求

需求 值
最低支援的用戶端 Windows Vista
目標平台 桌面
標頭 dispmprt.h
IRQL PASSIVE_LEVEL

另請參閱

DxgkDdiRemoveDevice

DxgkDdiStartDevice