DXGKDDI_MIRACAST_CREATE_CONTEXT回呼函式 (dispmprt.h)
建立Miracast裝置的核心模式內容。
語法
DXGKDDI_MIRACAST_CREATE_CONTEXT DxgkddiMiracastCreateContext;
NTSTATUS DxgkddiMiracastCreateContext(
[in] PVOID DriverContext,
[in] DXGK_MIRACAST_DISPLAY_CALLBACKS *MiracastCallbacks,
[out] PVOID *MiracastContext,
[out] ULONG *TargetId
)
{...}
參數
[in] DriverContext
與顯示配接器相關聯的內容區塊句柄。 顯示迷你埠驅動程式的 DxgkDdiAddDevice 函式先前已將此句柄提供給 DirectX 圖形核心子系統。
[in] MiracastCallbacks
操作系統提供的緩衝區指標,其中包含驅動程式可以呼叫之回呼函式的 DXGK_MIRACAST_DISPLAY_CALLBACKS 結構指標。
[out] MiracastContext
操作系統提供的緩衝區指標,此緩衝區會保存驅動程式為此Miracast裝置實例配置的內容位址。
[out] TargetId
操作系統提供的緩衝區指標,該緩衝區會保存Miracast裝置所連線之 VidPN 目標的標識碼。 當操作系統在裝置初始化期間呼叫 DxgkDdiQueryChildRelations 函式時,驅動程式應將此目標回報為類型D3DKMDT_VOT_MIRACAST。
傳回值
如果成功,則會 傳回STATUS_SUCCESS 。 否則,它會傳回 Ntstatus.h 中定義的其中一個錯誤碼,包括:
傳回碼 | Description |
---|---|
STATUS_RESOURCE_IN_USE | 目前無法使用支援Miracast聯機會話所需的硬體資源。 |
備註
呼叫此函式時,顯示迷你埠驅動程式應該準備它支援Miracast聯機會話所需的所有內核模式資源。
同步
操作系統會將 DxgkDdiMiracastCreateContext、 DxgkDdiMiracastDestroyContext 和 DxgkDdiMiracastIoControl 函式分組為 Miracast 類別。 操作系統保證這些函式遵循 線程和同步處理第二層中所定義的第二層同步處理模式。 當在另一個線程內容上呼叫層級 0、1 或其他層級 2 函式類別時,可以呼叫這些函式。 不過,一次只能呼叫這 2 層 Miracast 類別函式的其中一個。規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8.1 |
最低支援的伺服器 | Windows Server 2012 R2 |
目標平台 | 桌面 |
標頭 | dispmprt.h (包含 Dispmprt.h) |
IRQL | PASSIVE_LEVEL |