OPMGetVideoOutputsFromHMONITOR 函式 (opmapi.h)

針對與特定 HMONITOR 控制碼相關聯的每個實體監視器，建立 Output Protection Manager (OPM) 物件。

語法

HRESULT OPMGetVideoOutputsFromHMONITOR(
  [in]  HMONITOR                   hMonitor,
  [in]  OPM_VIDEO_OUTPUT_SEMANTICS vos,
  [out] ULONG                      *pulNumVideoOutputs,
  [out] IOPMVideoOutput            ***pppOPMVideoOutputArray
);

參數

[in] hMonitor

要為其建立 OPM 物件的監視控制碼。 有數個函式會傳回 HMONITOR 值。 如需詳細資訊，請參閱 Windows 圖形裝置介面中的 多個顯示器監視器函 式主題， (GDI) 檔。

[in] vos

OPM_VIDEO_OUTPUT_SEMANTICS列舉的成員。

[out] pulNumVideoOutputs

接收pppOPMVideoOutputArray參數中傳回的IOPMVideoOutput指標數目。

[out] pppOPMVideoOutputArray

接收 IOPMVideoOutput 指標陣列的指標。 每個 IOPMVideoOutput 指標都與單一實體監視器相關聯。 呼叫端必須釋放陣列中的每個指標，並呼叫 CoTaskMemFree 以釋放陣列。

傳回值

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

單一 HMONITOR 控制碼可以與數個實體監視器相關聯。 每個實體監視器都有自己的連接器。 應用程式必須使用pppOPMVideoOutputArray中傳回的IOPMVideoOutput指標，個別設定每個實體監視器的保護機制。

IOPMVideoOutput介面有兩種行為模式，視vos參數的值而定。 如果 vosOPM_VOS_COPP_SEMANTICS， IOPMVideoOutput 會使用 COPP 語意。 此模式適用于與 COPP 的回溯相容性。 如果 vosOPM_VOS_OPM_SEMANTICS， IOPMVideoOutput 會使用較新的 OPM 語意。 每個方法的參考頁面上會說明行為差異。 模式不會在物件的存留期期間變更。

需求

另請參閱

OPM 函式