mmioAscend

関数

RIFFファイルのチャンクから上のレベルへ戻る。

DLLWINMM.dll呼出規約winapi対応OSWindows 2000 以降

シグネチャ

// WINMM.dll
#include <windows.h>

DWORD mmioAscend(
    HMMIO hmmio,
    MMCKINFO* pmmcki,
    DWORD fuAscend
);

パラメーター

名前	型	方向	説明
hmmio	HMMIO	in	開いている RIFF ファイルのファイルハンドル。
pmmcki	MMCKINFO*	in	あらかじめ mmioDescend 関数または mmioCreateChunk 関数によって設定された、アプリケーション定義の MMCKINFO 構造体へのポインター。
fuAscend	DWORD	in	予約済み。0 でなければなりません。

戻り値の型: DWORD

公式ドキュメント

mmioAscend 関数は、mmioDescend 関数で入った、または mmioCreateChunk 関数で作成した RIFF ファイル内のチャンクから出ます。

戻り値

成功した場合は MMSYSERR_NOERROR を、それ以外の場合はエラーを返します。考えられるエラー値は次のとおりです。

戻り値	説明
MMIOERR_CANNOTSEEK	チャンクの末尾へのシーク中にエラーが発生しました。
MMIOERR_CANNOTWRITE	バッファーの内容をディスクに書き込めませんでした。

解説(Remarks)

mmioDescend を使用してチャンクに入った場合、mmioAscend はチャンクの末尾に続く位置(パッドバイトがある場合はその後)へシークします。

mmioCreateChunk を使用してチャンクを作成して入った場合、または lpck が参照する MMCKINFO 構造体の dwFlags メンバーに MMIO_DIRTY フラグが設定されている場合、現在のファイル位置がチャンクのデータ部分の末尾であるとみなされます。チャンクサイズが、mmioCreateChunk 呼び出し時に MMCKINFO 構造体の cksize メンバーに格納された値と異なる場合、mmioAscend はチャンクから出る前にファイル内のチャンクサイズを修正します。チャンクサイズが奇数の場合、mmioAscend はチャンクの末尾に null のパッドバイトを書き込みます。チャンクから出た後、現在のファイル位置はチャンクの末尾に続く位置(パッドバイトがある場合はその後)になります。

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

各言語での呼び出し定義

// WINMM.dll
#include <windows.h>

DWORD mmioAscend(
    HMMIO hmmio,
    MMCKINFO* pmmcki,
    DWORD fuAscend
);

[DllImport("WINMM.dll", ExactSpelling = true)]
static extern uint mmioAscend(
    IntPtr hmmio,   // HMMIO
    IntPtr pmmcki,   // MMCKINFO*
    uint fuAscend   // DWORD
);

<DllImport("WINMM.dll", ExactSpelling:=True)>
Public Shared Function mmioAscend(
    hmmio As IntPtr,   ' HMMIO
    pmmcki As IntPtr,   ' MMCKINFO*
    fuAscend As UInteger   ' DWORD
) As UInteger
End Function

' hmmio : HMMIO
' pmmcki : MMCKINFO*
' fuAscend : DWORD
Declare PtrSafe Function mmioAscend Lib "winmm" ( _
    ByVal hmmio As LongPtr, _
    ByVal pmmcki As LongPtr, _
    ByVal fuAscend As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

mmioAscend = ctypes.windll.winmm.mmioAscend
mmioAscend.restype = wintypes.DWORD
mmioAscend.argtypes = [
    wintypes.HANDLE,  # hmmio : HMMIO
    ctypes.c_void_p,  # pmmcki : MMCKINFO*
    wintypes.DWORD,  # fuAscend : DWORD
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('WINMM.dll')
mmioAscend = Fiddle::Function.new(
  lib['mmioAscend'],
  [
    Fiddle::TYPE_VOIDP,  # hmmio : HMMIO
    Fiddle::TYPE_VOIDP,  # pmmcki : MMCKINFO*
    -Fiddle::TYPE_INT,  # fuAscend : DWORD
  ],
  -Fiddle::TYPE_INT)

#[link(name = "winmm")]
extern "system" {
    fn mmioAscend(
        hmmio: *mut core::ffi::c_void,  // HMMIO
        pmmcki: *mut MMCKINFO,  // MMCKINFO*
        fuAscend: u32  // DWORD
    ) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("WINMM.dll")]
public static extern uint mmioAscend(IntPtr hmmio, IntPtr pmmcki, uint fuAscend);
"@
$api = Add-Type -MemberDefinition $sig -Name 'WINMM_mmioAscend' -Namespace Win32 -PassThru
# $api::mmioAscend(hmmio, pmmcki, fuAscend)

#uselib "WINMM.dll"
#func global mmioAscend "mmioAscend" sptr, sptr, sptr
; mmioAscend hmmio, varptr(pmmcki), fuAscend   ; 戻り値は stat
; hmmio : HMMIO -> "sptr"
; pmmcki : MMCKINFO* -> "sptr"
; fuAscend : DWORD -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "WINMM.dll"
#cfunc global mmioAscend "mmioAscend" sptr, var, int
; res = mmioAscend(hmmio, pmmcki, fuAscend)
; hmmio : HMMIO -> "sptr"
; pmmcki : MMCKINFO* -> "var"
; fuAscend : DWORD -> "int"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "WINMM.dll"
#cfunc global mmioAscend "mmioAscend" sptr, sptr, int
; res = mmioAscend(hmmio, varptr(pmmcki), fuAscend)
; hmmio : HMMIO -> "sptr"
; pmmcki : MMCKINFO* -> "sptr"
; fuAscend : DWORD -> "int"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。