7.36. ioctl VIDIOC_G_OUTPUT, VIDIOC_S_OUTPUT

7.36.1. 名稱

VIDIOC_G_OUTPUT - VIDIOC_S_OUTPUT - 查詢或選擇當前影片輸出

7.36.2. 概要

VIDIOC_G_OUTPUT

int ioctl(int fd, VIDIOC_G_OUTPUT, int *argp)

VIDIOC_S_OUTPUT

int ioctl(int fd, VIDIOC_S_OUTPUT, int *argp)

7.36.3. 引數

fd

由 open() 返回的檔案描述符。

argp

指向具有輸出索引的整數的指標。

7.36.4. 描述

要查詢當前影片輸出，應用程式呼叫 VIDIOC_G_OUTPUT ioctl，並帶有一個指向整數的指標，驅動程式在該整數中儲存輸出的編號，如 struct v4l2_output index 欄位。僅當沒有影片輸出時，此 ioctl 才會失敗，並返回 EINVAL 錯誤程式碼。

要選擇影片輸出，應用程式將所需的輸出編號儲存在一個整數中，並呼叫 VIDIOC_S_OUTPUT ioctl，並帶有一個指向該整數的指標。可能會產生副作用。例如，輸出可能支援不同的影片標準，因此驅動程式可能會隱式切換當前標準。由於這些可能的副作用，應用程式必須在查詢或協商任何其他引數之前選擇一個輸出。

有關影片輸出的資訊可使用 ioctl VIDIOC_ENUMOUTPUT ioctl 獲取。

7.36.5. 返回值

成功時返回 0，出錯時返回 -1，並適當地設定 errno 變數。通用錯誤程式碼在 通用錯誤程式碼 章節中描述。

EINVAL

影片輸出的編號超出範圍，或者根本沒有影片輸出。