mmioGetInfo-Funktion (mmiscapi.h)

  • Artikel

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