Share via

funzione mmioGetInfo (mmiscapi.h)

  • Articolo

La funzione mmioGetInfo recupera informazioni su un file aperto usando la funzione mmioOpen . Queste informazioni consentono all'applicazione di accedere direttamente al buffer di I/O, se il file viene aperto per l'I/O memorizzato nel buffer.

Sintassi

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

Parametri

hmmio

Handle file del file.

pmmioinfo

Puntatore a un buffer che riceve una struttura MMIOINFO che mmioGetInfo riempie con informazioni sul file.

fuInfo

Riservati; deve essere zero.

Valore restituito

Restituisce zero se ha esito positivo o un errore in caso contrario.

Commenti

Per accedere direttamente al buffer di I/O di un file aperto per I/O con buffer, usare i membri seguenti della struttura MMIOINFO compilata da mmioGetInfo:

  • Il membro pchNext punta al byte successivo nel buffer che può essere letto o scritto. Quando si legge o si scrive, incrementa pchNext per il numero di byte letti o scritti.
  • Il membro pchEndRead punta a 1 byte oltre l'ultimo byte valido nel buffer che può essere letto.
  • Il membro pchEndWrite punta a 1 byte oltre l'ultima posizione nel buffer che può essere scritto.
Dopo aver letto o scritto nel buffer e modificato pchNext, non chiamare alcuna funzione di I/O di file multimediali tranne mmioAdvance finché non si chiama la funzione mmioSetInfo . Chiamare mmioSetInfo al termine dell'accesso diretto al buffer.

Quando si raggiunge la fine del buffer specificato dal membro pchEndRead o pchEndWrite , chiamare mmioAdvance per riempire il buffer dal disco o scrivere il buffer nel disco. La funzione mmioAdvance aggiorna i membri pchNext, pchEndRead epchEndWrite nella struttura MMIOINFO per il file.

Prima di chiamare mmioAdvance o mmioSetInfo per scaricare un buffer su disco, impostare il flag di MMIO_DIRTY nel membro dwFlags della struttura MMIOINFO per il file. In caso contrario, il buffer non verrà scritto su disco.

Non decrementare pchNext o modificare i membri nella struttura MMIOINFO diversi da pchNext e dwFlags. Non impostare flag in dwFlags tranne MMIO_DIRTY.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione mmiscapi.h (includono Mmiscapi.h, Windows.h)
Libreria Winmm.lib
DLL Winmm.dll