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，操作系統將會處理呼叫。

規格需求

另請參閱

CreateMiracastContext

DestroyMiracastContext

StartMiracastSession

StopMiracastSession