PFN_MIRACAST_IO_CONTROL回呼函式 (netdispumdddi.h)
由使用者模式顯示驅動程式呼叫,以傳送核心模式顯示迷你埠驅動程式同步 I/O 控制要求。此函式的數據類型 PFN_MIRACAST_IO_CONTROL。
語法
PFN_MIRACAST_IO_CONTROL PfnMiracastIoControl;
NTSTATUS PfnMiracastIoControl(
[in] HANDLE hMiracastDeviceHandle,
[in] BOOL HardwareAccess,
[in] UINT InputBufferSize,
[in] VOID *pInputBuffer,
[in] UINT OutputBufferSize,
[out] VOID *pOutputBuffer,
[out, optional] UINT *pBytesReturned
)
{...}
參數
[in] hMiracastDeviceHandle
表示 Miracast 裝置的句柄。 Miracast 使用者模式驅動程式先前在呼叫 CreateMiracastContext 函式時取得此句柄作為 hMiracastDeviceHandle 參數。
[in] HardwareAccess
布爾值,指出使用者模式顯示驅動程式的這個 I/O 控制項要求是否需要清除所有擱置的 GPU DMA 緩衝區。
我們不建議驅動程序視需要將此值設定為 TRUE ,因為排清 GPU 將會產生大量的處理額外負荷。
[in] InputBufferSize
pInputBuffer 所指向之輸入緩衝區的大小,以位元組為單位。
[in] pInputBuffer
輸入緩衝區的指標。 InputBufferSize 參數會指定緩衝區的大小。
[in] OutputBufferSize
pOutputBuffer 所指向輸出緩衝區的大小,以位元組為單位。
[out] pOutputBuffer
驅動程式提供的輸出緩衝區指標。 OutputBufferSize 參數會指定緩衝區的大小。
[out, optional] pBytesReturned
選擇性驅動程式提供的 UINT 類型變數指標,可保存顯示迷你埠驅動程式傳回的位元組數目。
傳回值
成功時,操作系統會傳回 STATUS_SUCCESS。 否則,函式會傳回 Ntstatus.h 標頭中定義的錯誤碼。
備註
如果Miracast使用者模式驅動程式在操作系統啟動Miracast會話時呼叫 MiracastIoControl ,而且呼叫線程不是操作系統呼叫 StartMiracastSession 函式的線程,則操作系統會封鎖 MiracastIoControl 呼叫,直到Miracast開始會話完成為止。 如果使用者模式驅動程式在與 CreateMiracastContext 或 StartMiracastSession 函式中使用的相同內容中呼叫 MiracastIoControl,操作系統將會處理呼叫。
如果Miracast使用者模式驅動程式在作業系統停止Miracast會話時呼叫 MiracastIoControl ,而且呼叫線程不是操作系統呼叫 SMiracastSession 函式的線程,則操作系統將會失敗此呼叫。 如果使用者模式驅動程式在與 StopMiracastSession 或 DestroyMiracastContext 函式中使用的相同內容中呼叫 MiracastIoControl,操作系統將會處理呼叫。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8.1 |
最低支援的伺服器 | Windows Server 2012 R2 |
目標平台 | 桌面 |
標頭 | netdispumdddi.h (包含 Netdispumdddi.h) |