Win32 API 日本語リファレンス
ホーム › Media.Multimedia › ICOPEN

ICOPEN

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 56 バイト / x86: 36 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールド型サイズx64x86説明
dwSizeDWORD4+0+0構造体のサイズ (バイト単位)。
fccTypeDWORD4+4+4圧縮または展開されるストリームの種類を示す 4 文字コードです。ビデオストリームの場合は "VIDC" を指定します。
fccHandlerDWORD4+8+8特定のコンプレッサーを識別する 4 文字コードです。
dwVersionDWORD4+12+12ドライバーを開くために使用されたインストール可能ドライバーインターフェイスのバージョンです。
dwFlagsDWORD4+16+16

ドライバーが開かれた理由を示すフラグです。次の値が定義されています。

名前 説明
ICMODE_COMPRESS
 データを圧縮するためにドライバーが開かれました。
ICMODE_DECOMPRESS
 データを展開するためにドライバーが開かれました。
ICMODE_DRAW
 データをハードウェアに直接展開するためにデバイスドライバーが開かれました。
ICMODE_QUERY
 圧縮のためではなく、情報を取得する目的でドライバーが開かれました。
dwErrorLRESULT8/4+24+20オープン時のエラーコードを格納する領域(LRESULT)。
pV1Reservedvoid*8/4+32+24予約済みです。使用しないでください。
pV2Reservedvoid*8/4+40+28予約済みです。使用しないでください。
dnDevNodeDWORD4+48+32プラグアンドプレイデバイスのデバイスノードです。

公式ドキュメント

ICOPEN 構造体には、圧縮または展開されるデータストリームに関する情報、ドライバーのバージョン番号、およびドライバーの使用方法が格納されます。

解説(Remarks)

この構造体は、ビデオキャプチャドライバーが開かれるときに渡されます。これにより、単一のインストール可能ドライバーが、インストール可能コンプレッサーとしても、ビデオキャプチャデバイスとしても機能できます。ドライバーは ICOPEN 構造体の fccType メンバーを調べることで、自身の機能を判別できます。たとえば、fccType の値が "VIDC" の場合は、インストール可能ビデオコンプレッサーとして開かれたことを示します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// ICOPEN  (x64 56 / x86 36 バイト)
typedef struct ICOPEN {
    DWORD dwSize;
    DWORD fccType;
    DWORD fccHandler;
    DWORD dwVersion;
    DWORD dwFlags;
    LRESULT dwError;
    void* pV1Reserved;
    void* pV2Reserved;
    DWORD dnDevNode;
} ICOPEN;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct ICOPEN
{
    public uint dwSize;
    public uint fccType;
    public uint fccHandler;
    public uint dwVersion;
    public uint dwFlags;
    public IntPtr dwError;
    public IntPtr pV1Reserved;
    public IntPtr pV2Reserved;
    public uint dnDevNode;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure ICOPEN
    Public dwSize As UInteger
    Public fccType As UInteger
    Public fccHandler As UInteger
    Public dwVersion As UInteger
    Public dwFlags As UInteger
    Public dwError As IntPtr
    Public pV1Reserved As IntPtr
    Public pV2Reserved As IntPtr
    Public dnDevNode As UInteger
End Structure
import ctypes
from ctypes import wintypes

class ICOPEN(ctypes.Structure):
    _fields_ = [
        ("dwSize", wintypes.DWORD),
        ("fccType", wintypes.DWORD),
        ("fccHandler", wintypes.DWORD),
        ("dwVersion", wintypes.DWORD),
        ("dwFlags", wintypes.DWORD),
        ("dwError", ctypes.c_ssize_t),
        ("pV1Reserved", ctypes.c_void_p),
        ("pV2Reserved", ctypes.c_void_p),
        ("dnDevNode", wintypes.DWORD),
    ]
#[repr(C)]
pub struct ICOPEN {
    pub dwSize: u32,
    pub fccType: u32,
    pub fccHandler: u32,
    pub dwVersion: u32,
    pub dwFlags: u32,
    pub dwError: isize,
    pub pV1Reserved: *mut core::ffi::c_void,
    pub pV2Reserved: *mut core::ffi::c_void,
    pub dnDevNode: u32,
}
import "golang.org/x/sys/windows"

type ICOPEN struct {
	dwSize uint32
	fccType uint32
	fccHandler uint32
	dwVersion uint32
	dwFlags uint32
	dwError uintptr
	pV1Reserved uintptr
	pV2Reserved uintptr
	dnDevNode uint32
}
type
  ICOPEN = record
    dwSize: DWORD;
    fccType: DWORD;
    fccHandler: DWORD;
    dwVersion: DWORD;
    dwFlags: DWORD;
    dwError: NativeInt;
    pV1Reserved: Pointer;
    pV2Reserved: Pointer;
    dnDevNode: DWORD;
  end;
const ICOPEN = extern struct {
    dwSize: u32,
    fccType: u32,
    fccHandler: u32,
    dwVersion: u32,
    dwFlags: u32,
    dwError: isize,
    pV1Reserved: ?*anyopaque,
    pV2Reserved: ?*anyopaque,
    dnDevNode: u32,
};
type
  ICOPEN {.bycopy.} = object
    dwSize: uint32
    fccType: uint32
    fccHandler: uint32
    dwVersion: uint32
    dwFlags: uint32
    dwError: int
    pV1Reserved: pointer
    pV2Reserved: pointer
    dnDevNode: uint32
struct ICOPEN
{
    uint dwSize;
    uint fccType;
    uint fccHandler;
    uint dwVersion;
    uint dwFlags;
    ptrdiff_t dwError;
    void* pV1Reserved;
    void* pV2Reserved;
    uint dnDevNode;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; ICOPEN サイズ: 36 バイト(x86)
dim st, 9    ; 4byte整数×9(構造体サイズ 36 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; fccType : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; fccHandler : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dwVersion : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; dwFlags : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; dwError : LRESULT (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; pV1Reserved : void* (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; pV2Reserved : void* (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; dnDevNode : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; ICOPEN サイズ: 56 バイト(x64)
dim st, 14    ; 4byte整数×14(構造体サイズ 56 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; fccType : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; fccHandler : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dwVersion : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; dwFlags : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; dwError : LRESULT (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; pV1Reserved : void* (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; pV2Reserved : void* (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; dnDevNode : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global ICOPEN
    #field int dwSize
    #field int fccType
    #field int fccHandler
    #field int dwVersion
    #field int dwFlags
    #field intptr dwError
    #field intptr pV1Reserved
    #field intptr pV2Reserved
    #field int dnDevNode
#endstruct

stdim st, ICOPEN        ; NSTRUCT 変数を確保
st->dwSize = 100
mes "dwSize=" + st->dwSize