DXGKDDI_ADD_DEVICE回呼函式 （dispmprt.h）
DxgkDdiAddDevice 函式會建立顯示配接器的內容區塊，並傳回代表顯示配接器的句柄。
語法
DXGKDDI_ADD_DEVICE DxgkddiAddDevice;
NTSTATUS DxgkddiAddDevice(
[in] IN_CONST_PDEVICE_OBJECT PhysicalDeviceObject,
[out] OUT_PPVOID MiniportDeviceContext
)
{...}
參數
[in] PhysicalDeviceObject
識別顯示適配卡之實體裝置物件的指標。
[out] MiniportDeviceContext
接收顯示迷你埠驅動程式所建立之句柄之變數的指標，代表由 physicalDeviceObject 所識別的顯示配接器。 顯示迷你埠驅動程式可以在此參數中傳回 NULL，表示它不支援由 PhysicalDeviceObject所識別的顯示配接器。
傳回值
DxgkDdiAddDevice 如果成功，則會傳回STATUS_SUCCESS;否則，它會傳回 Ntstatus.h中定義的其中一個錯誤碼。
言論
DxgkDdiAddDevice 函式會配置與 PhysicalDeviceObject 所識別之顯示配接器相關聯的私人內容區塊。 您可以將 MiniportDeviceCon text 中所傳回的句柄視為顯示適配卡的句柄或與顯示配接器相關聯的內容區塊句柄。 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 一次，此時顯示迷你埠驅動程式可以指出它支援PCI函式（將 MiniportDeviceContext 設為非零值），或不支援PCI函式（將 MiniportDeviceContext 設為 NULL）。 若要取得特定 PCI 函式的相關信息，顯示迷你埠驅動程式可以將 PhysicalDeviceObject 傳遞至 IoGetDeviceProperty。
在 DxgkDdiRemoveDevice中，釋放您的內容區塊，以及您在 DxgkDdiAddDevice期間配置的任何其他資源。
DxgkDdiAddDevice 函式應設為可分頁。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 目標平臺 | 桌面 |
| 標頭 | dispmprt.h |
| IRQL | PASSIVE_LEVEL |