VIDEOPARAMETERS 構造体 (tvout.h)

[アーティクル]
03/15/2023

ビデオミニポートドライバーは、IOCTL 要求がIOCTL_VIDEO_HANDLE_VIDEOPARAMETERSされたときに、VIDEO_REQUEST_PACKETの InputBuffer メンバー内の VIDEOPARAMETERS 構造体へのポインターを受け取ります。 VIDEOPARAMETERS 構造体の dwCommand メンバーに応じて、ミニポートドライバーは、テレビコネクタとデバイスのコピー保護機能を取得または設定する必要があります。

構文

typedef struct _VIDEOPARAMETERS {
  GUID  Guid;
  ULONG dwOffset;
  ULONG dwCommand;
  ULONG dwFlags;
  ULONG dwMode;
  ULONG dwTVStandard;
  ULONG dwAvailableModes;
  ULONG dwAvailableTVStandard;
  ULONG dwFlickerFilter;
  ULONG dwOverScanX;
  ULONG dwOverScanY;
  ULONG dwMaxUnscaledX;
  ULONG dwMaxUnscaledY;
  ULONG dwPositionX;
  ULONG dwPositionY;
  ULONG dwBrightness;
  ULONG dwContrast;
  ULONG dwCPType;
  ULONG dwCPCommand;
  ULONG dwCPStandard;
  ULONG dwCPKey;
  ULONG bCP_APSTriggerBits;
  UCHAR bOEMCopyProtection[256];
} VIDEOPARAMETERS, *PVIDEOPARAMETERS, *LPVIDEOPARAMETERS;

メンバー

Guid

この構造体 {02C62061-1097-11d1-920F-00A024DF156E} のグローバル一意識別子 (GUID) を指定します。ビデオミニポートドライバーは、構造体を処理する前に、構造体の開始時に GUID を確認する必要があります。

dwOffset

は予約されており、ビデオミニポートドライバーでは無視する必要があります。

dwCommand

ドライバーによって実行されるアクションを示します。このメンバーには、次のいずれかの値を指定できます。

VP_COMMAND_GET

ミニポートドライバーは、 dwFlags で適切なフラグを設定し、それらの設定フラグに対応するメンバーの値を設定することで、デバイスのすべての TV コネクタ機能、現在の TV コネクタ設定、コピー保護機能、および現在のコピー保護設定を返す必要があります。

VP_COMMAND_SET

ミニポートドライバーは、 dwFlags に設定されているフラグに対応するこの構造体のメンバーに従って、TV コネクタとコピー保護ハードウェアを設定する必要があります。

dwFlags

この構造体のどのメンバーに有効なデータが含まれているかを示します。 dwCommand がVP_COMMAND_GETされると、ドライバーは、有効なデータを返した対応するメンバーを示すために、このメンバーの適切なビットを設定する必要があります。 dwCommand がVP_COMMAND_SETされると、ドライバーは、このメンバーで設定されたビットに対応するメンバーの値に従って、ハードウェアの機能を設定する必要があります。このメンバーは、次の表の最初の列に示されている値のビットごとの OR にすることができます。

フラグ	対応するメンバー	コマンド
VP_FLAGS_BRIGHTNESS	dwBrightness	get/set
VP_FLAGS_CONTRAST	dwContrast	get/set
VP_FLAGS_COPYPROTECT	dwCPType dwCPCommand dwCPStandard dwCPKey bCP_APSTriggerBits bOEMCopyProtection	get/set set get set set get/set
VP_FLAGS_FLICKER	dwFlickerFilter	get/set
VP_FLAGS_MAX_UNSCALED	dwMaxUnscaledX dwMaxUnscaledY	get get
VP_FLAGS_OVERSCAN	dwOverscanX dwOverscanY	get/set get/set
VP_FLAGS_POSITION	dwPositionX dwPositionY	get/set get/set
VP_FLAGS_TV_MODE	dwMode dwAvailableModes	get/set get
VP_FLAGS_TV_STANDARD	dwTVStandard dwAvailableTVStandard	get/set get

dwMode

現在の再生モードを指定します。このメンバーは、VP_COMMAND_SET コマンドと VP_COMMAND_GET コマンドの両方に対して有効であり、次のいずれかの値を指定できます。

VP_MODE_TV_PLAYBACK

ちらつきフィルターをオフにし、オーバースキャン表示をオンにして、ビデオ再生に最適なフィールドセットについて説明します。

VP_MODE_WIN_GRAPHICS

Windows ディスプレイに最適な表示設定について説明します。最大ちらつきフィルターはオンで、オーバースキャンディスプレイはオフです。

dwTVStandard

現在の世界のテレビ標準です。このメンバーは、VP_COMMAND_SET コマンドと VP_COMMAND_GET コマンドの両方に対して有効であり、次のいずれかの値を指定できます。

VP_TV_STANDARD_NTSC_M

VP_TV_STANDARD_NTSC_M_J

VP_TV_STANDARD_NTSC_433

VP_TV_STANDARD_PAL_B

VP_TV_STANDARD_PAL_D

VP_TV_STANDARD_PAL_G

VP_TV_STANDARD_PAL_H

VP_TV_STANDARD_PAL_I

VP_TV_STANDARD_PAL_M

VP_TV_STANDARD_PAL_N

VP_TV_STANDARD_PAL_60

VP_TV_STANDARD_SECAM_B

VP_TV_STANDARD_SECAM_D

VP_TV_STANDARD_SECAM_G

VP_TV_STANDARD_SECAM_H

VP_TV_STANDARD_SECAM_K

VP_TV_STANDARD_SECAM_K1

VP_TV_STANDARD_SECAM_L

VP_TV_STANDARD_SECAM_L1

VP_TV_STANDARD_WIN_VGA

dwAvailableModes

デバイスで使用できる再生モードを示します。このメンバーは、VP_COMMAND_GET コマンドに対してのみ有効であり、次の値のビットごとの OR にすることができます。

VP_MODE_TV_PLAYBACK

VP_MODE_WIN_GRAPHICS

dwAvailableTVStandard

使用可能なすべての世界テレビ標準を指定します。このメンバーは、VP_COMMAND_GET コマンドに対してのみ有効であり、次の値のビットごとの OR にすることができます。

VP_TV_STANDARD_NTSC_M

VP_TV_STANDARD_NTSC_M_J

VP_TV_STANDARD_NTSC_433

VP_TV_STANDARD_PAL_B

VP_TV_STANDARD_PAL_D

VP_TV_STANDARD_PAL_G

VP_TV_STANDARD_PAL_H

VP_TV_STANDARD_PAL_I

VP_TV_STANDARD_PAL_M

VP_TV_STANDARD_PAL_N

VP_TV_STANDARD_PAL_60

VP_TV_STANDARD_SECAM_B

VP_TV_STANDARD_SECAM_D

VP_TV_STANDARD_SECAM_G

VP_TV_STANDARD_SECAM_H

VP_TV_STANDARD_SECAM_K

VP_TV_STANDARD_SECAM_K1

VP_TV_STANDARD_SECAM_L

VP_TV_STANDARD_SECAM_L1

VP_TV_STANDARD_WIN_VGA

dwFlickerFilter

ちらつきフィルターの状態を示すパーセントの 10 分の 1 の値です。このメンバーには [0,1000] の値を指定でき、VP_COMMAND_GETとVP_COMMAND_SETの両方で有効です。

dwOverScanX

x でのオーバースキャンの量を示す 10 分の 1 の割合の値です。このメンバーには [0,1000] の値を指定でき、VP_COMMAND_GETとVP_COMMAND_SETの両方で有効です。

dwOverScanY

y でのオーバースキャンの量を示すパーセントの 10 分の 1 の値です。このメンバーには [0,1000] の値を指定でき、VP_COMMAND_GETとVP_COMMAND_SETの両方で有効です。

dwMaxUnscaledX

ハードウェアを使用せずにテレビに表示できる最大 x 解像度は、ビデオイメージをスケーリングします。ミニポートドライバーは、 dwCommand がVP_COMMAND_GETされるときに、このメンバーの値を設定する必要があります。このメンバーは、VP_COMMAND_SETに対して無効です。

dwMaxUnscaledY

ビデオイメージをハードウェアスケールせずにテレビが表示できる最大 y 解像度です。ミニポートドライバーは、 dwCommand がVP_COMMAND_GETされるときに、このメンバーの値を設定する必要があります。このメンバーは、VP_COMMAND_SETに対して無効です。

dwPositionX

テレビ上の画像の現在の x 位置を決定するためにハードウェアによって使用される値です。このメンバーはピクセル単位で指定され、VP_COMMAND_GETとVP_COMMAND_SETの両方で有効です。

dwPositionY

テレビ上の画像の現在の y 位置を決定するためにハードウェアによって使用される値です。このメンバーはスキャンラインで指定され、VP_COMMAND_GETとVP_COMMAND_SETの両方で有効です。

dwBrightness

テレビの明るさの設定を示すパーセンテージ値です。このメンバーには [0,100] の値を指定でき、VP_COMMAND_GETとVP_COMMAND_SETの両方で有効です。

dwContrast

テレビのコントラスト設定を示すパーセンテージ値です。このメンバーには [0,100] の値を指定でき、VP_COMMAND_GETとVP_COMMAND_SETの両方で有効です。

dwCPType

デバイスでサポートされるコピー保護の種類を指定します。このメンバーは、VP_COMMAND_SET コマンドと VP_COMMAND_GET コマンドの両方に対して有効であり、CP_TYPE_APS_TRIGGERできます。

dwCPCommand

コピー保護コマンドです。このメンバーは、VP_COMMAND_SET コマンドに対してのみ有効であり、次のいずれかの値を指定できます。

VP_CP_CMD_ACTIVATE

ミニポートドライバーは、コピー保護を有効にし、 dwCPKey で一意のコピー保護キーを生成して返す必要があります。

VP_CP_CMD_CHANGE

dwCPKey のコピー保護キーが有効な場合、ミニポートドライバーは、bCP_APSTriggerBitsのトリガーデータに基づいてコピー保護を変更する必要があります。

VP_CP_CMD_DEACTIVATE

dwCPKey のコピー保護キーが有効な場合、ミニポートドライバーはコピー保護を無効にする必要があります。

dwCPStandard

コピー保護の種類を使用できるテレビ標準です。このメンバーは、VP_COMMAND_GET コマンドに対してのみ有効であり、次の値のビットごとの OR にすることができます。

VP_TV_STANDARD_NTSC_M

VP_TV_STANDARD_NTSC_M_J

VP_TV_STANDARD_NTSC_433

VP_TV_STANDARD_PAL_B

VP_TV_STANDARD_PAL_D

VP_TV_STANDARD_PAL_G

VP_TV_STANDARD_PAL_H

VP_TV_STANDARD_PAL_I

VP_TV_STANDARD_PAL_M

VP_TV_STANDARD_PAL_N

VP_TV_STANDARD_PAL_60

VP_TV_STANDARD_SECAM_B

VP_TV_STANDARD_SECAM_D

VP_TV_STANDARD_SECAM_G

VP_TV_STANDARD_SECAM_H

VP_TV_STANDARD_SECAM_K

VP_TV_STANDARD_SECAM_K1

VP_TV_STANDARD_SECAM_L

VP_TV_STANDARD_SECAM_L1

VP_TV_STANDARD_WIN_VGA

dwCPKey

ドライバーのこのインスタンスに固有のドライバーによって生成されたコピー保護キーです。このメンバーは、VP_COMMAND_SET コマンドに対してのみ有効です。ミニポートドライバーは、 dwCPCommand が VP_CP_CMD_ACTIVATEに設定されている場合に、このキーを生成して返します。 dwCPCommand フィールドがVP_CP_CMD_DEACTIVATEまたはVP_CP_CMD_CHANGEの場合、呼び出し元はこのキーを設定する必要があります。呼び出し元が正しくないキーを設定した場合、ドライバーは現在のコピー保護設定を変更しないでください。

bCP_APSTriggerBits

DVD アナログ保護システム (APS) トリガービットデータを指定します。ビット 0 と 1 は有効です。このメンバーは、VP_COMMAND_SET コマンドに対してのみ有効です。

bOEMCopyProtection[256]

OEM 固有のコピー保護データ。このメンバーは、VP_COMMAND_SET コマンドと VP_COMMAND_GET コマンドの両方で有効です。

要件

要件	値
Header	tvout.h (Tvout.h を含む)

こちらもご覧ください

IOCTL_VIDEO_HANDLE_VIDEOPARAMETERS

VIDEO_REQUEST_PACKET

次の方法で共有

VIDEOPARAMETERS 構造体 (tvout.h)

構文

メンバー

VP_COMMAND_GET

VP_COMMAND_SET

VP_MODE_TV_PLAYBACK

VP_MODE_WIN_GRAPHICS

VP_CP_CMD_ACTIVATE

VP_CP_CMD_CHANGE

VP_CP_CMD_DEACTIVATE

要件

こちらもご覧ください

フィードバック

その他のリソース