mmioGetInfo-Funktion (mmiscapi.h)

Artikel
08/24/2023

Die mmioGetInfo-Funktion ruft Informationen zu einer Datei ab, die mithilfe der mmioOpen-Funktion geöffnet wurde. Diese Informationen ermöglichen es der Anwendung, direkt auf den E/A-Puffer zuzugreifen, wenn die Datei für gepufferte E/A geöffnet wird.

Syntax

MMRESULT mmioGetInfo(
  HMMIO      hmmio,
  LPMMIOINFO pmmioinfo,
  UINT       fuInfo
);

Parameter

hmmio

Dateihandle der Datei.

pmmioinfo

Zeiger auf einen Puffer, der eine MMIOINFO-Struktur empfängt, die mmioGetInfo mit Informationen zur Datei auffüllt.

fuInfo

Reserviert; muss null sein.

Rückgabewert

Gibt null zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt.

Hinweise

Um direkt auf den E/A-Puffer einer Datei zuzugreifen, die für gepufferte E/A geöffnet wurde, verwenden Sie die folgenden Member der MMIOINFO-Struktur , die von mmioGetInfo gefüllt wird:

Das pchNext-Element zeigt auf das nächste Byte im Puffer, das gelesen oder geschrieben werden kann. Wenn Sie lesen oder schreiben, erhöhen Sie pchNext um die Anzahl der gelesenen oder geschriebenen Bytes.
Das pchEndRead-Element zeigt auf ein Byte nach dem letzten gültigen Byte im Puffer, der gelesen werden kann.
Der pchEndWrite-Member zeigt auf 1 Byte nach der letzten Position im Puffer, die geschrieben werden kann.

Nachdem Sie den Puffer gelesen oder in den Puffer geschrieben und pchNext geändert haben, rufen Sie keine E/A-Funktionen für Multimediadateien außer mmioAdvance auf, bis Sie die mmioSetInfo-Funktion aufrufen. Rufen Sie mmioSetInfo auf, wenn Sie den direkten Zugriff auf den Puffer abgeschlossen haben.

Wenn Sie das Ende des Puffers erreichen, der vom pchEndRead - oder pchEndWrite-Member angegeben ist, rufen Sie mmioAdvance auf, um den Puffer vom Datenträger aufzufüllen oder den Puffer auf den Datenträger zu schreiben. Die mmioAdvance-Funktion aktualisiert die Elemente pchNext, pchEndRead und pchEndWrite in der MMIOINFO-Struktur für die Datei.

Legen Sie vor dem Aufrufen von mmioAdvance oder mmioSetInfo zum Leeren eines Puffers auf den Datenträger das flag MMIO_DIRTY im dwFlags-Element der MMIOINFO-Struktur für die Datei fest. Andernfalls wird der Puffer nicht auf den Datenträger geschrieben.

Dekrementieren Sie pchNext nicht, oder ändern Sie keine Member in der MMIOINFO-Struktur außer pchNext und dwFlags. Legen Sie in dwFlags außer MMIO_DIRTY keine Flags fest.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mmiscapi.h (include Mmiscapi.h, Windows.h)
Bibliothek	Winmm.lib
DLL	Winmm.dll

Freigeben über