Wyszukiwanie fragmentu podrzędnego

[Funkcja skojarzona z tą stroną, I/O plików multimedialnych, jest starszą funkcją. Został zastąpiony przez Source Reader. Source Reader został zoptymalizowany pod kątem systemów Windows 10 i Windows 11. Firma Microsoft zdecydowanie zaleca, aby nowy kod używał Source Reader zamiast Multimedia File I/O, jeśli jest to możliwe. Firma Microsoft sugeruje, że istniejący kod, który używa starszych interfejsów API, należy przepisać go do korzystania z nowych interfejsów API, jeśli to możliwe.]

W poniższym przykładzie użyto funkcji mmioDescend, aby wyszukać fragment "FMT" w części "RIFF" poprzedniego przykładu.

// Find the format chunk (form type "FMT"); it should be 
// a subchunk of the "RIFF" parent chunk. 
mmckinfoSubchunk.ckid = mmioFOURCC('f', 'm', 't', ' '); 
if (mmioDescend(hmmio, &mmckinfoSubchunk, &mmckinfoParent, 
    MMIO_FINDCHUNK)) 
    // Error, cannot find the "FMT" chunk. 
else 
    // "FMT" chunk found. 

Aby wyszukać fragment podrzędny (czyli dowolny fragment inny niż fragment "RIFF" lub "LIST"), zidentyfikuj jego fragment nadrzędny w lpckParent parametru mmioDescend funkcji.

Jeśli nie określisz fragmentu nadrzędnego, bieżące położenie pliku powinno znajdować się na początku fragmentu przed wywołaniem funkcji mmioDescend. Jeśli określisz fragment nadrzędny, bieżące położenie pliku może znajdować się w dowolnym miejscu tego fragmentu.

Jeśli wyszukiwanie fragmentu podrzędnego zakończy się niepowodzeniem, bieżące położenie pliku jest niezdefiniowane. Możesz użyć funkcji mmioSeek oraz elementu dwDataOffset struktury MMCKINFO opisującej fragment nadrzędny, aby wrócić do początku fragmentu nadrzędnego, jak w poniższym przykładzie:

mmioSeek(hmmio, mmckinfoParent.dwDataOffset + 4, SEEK_SET); 

Ponieważ dwDataOffset określa przesunięcie do początku części danych fragmentu, należy przesunąć się o 4 bajty za dwDataOffset, aby ustawić położenie pliku po typie formularza.