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 將句柄傳遞至顯示迷你埠驅動程式所實作的函式。
顯示埠驅動程式會在 DxgkDdiStartDevice 函式的 MiniportDeviceContext 參數中提供句柄。
VidPN 管理員會在 DxgkDdiIsSupportedVidPn 函式的 hAdapter 參數中提供句柄。
DirectX 圖形核心會在 DxgkDdiQueryAdapterInfo 函式的 hAdapter 參數中提供句柄。
請勿混淆有時句柄的名稱為 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 |