CreateDecompressor-Funktion (compressapi.h)
Generiert einen neuen DECOMPRESSOR_HANDLE.
Syntax
BOOL CreateDecompressor(
[in] DWORD Algorithm,
[in, optional] PCOMPRESS_ALLOCATION_ROUTINES AllocationRoutines,
[out] PDECOMPRESSOR_HANDLE DecompressorHandle
);
Parameter
[in] Algorithm
Der Typ des Komprimierungsalgorithmus und des Modus, der von diesem Dekomprimierungsmodus verwendet werden soll.
Dieser Parameter kann über einen der folgenden Werte verfügen, der optional mit dem flag COMPRESS_RAW kombiniert wird. Verwenden Sie einen "bitweisen OR"-Operator, um COMPRESS_RAW einzuschließen und eine Blockmodusdekomprimierung zu erstellen. Wenn COMPRESS_RAW nicht enthalten ist, erstellt die Komprimierungs-API eine Puffermodus-Dekomprimierung. Weitere Informationen zum Auswählen eines Komprimierungsalgorithmus und -modus finden Sie unter Verwenden der Komprimierungs-API.
[in, optional] AllocationRoutines
Optionale Speicherbelegungs- und Freigaberoutinen in einer COMPRESS_ALLOCATION_ROUTINES-Struktur .
[out] DecompressorHandle
Wenn die Funktion erfolgreich ist, wird das Handle zum angegebenen Dekomprimierungsvorgang verwendet.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null. Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Wenn der Komprimierungsalgorithmus aus einem internen Grund fehlschlägt, kann der Fehler von GetLastErrorERROR_FUNCTION_FAILED werden. Wenn das System keinen Komprimierungsalgorithmus findet, der dem angegebenen Namen und der angegebenen Version entspricht, kann der Fehler ERROR_NOT_SUPPORTED werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | compressapi.h |
| Bibliothek | Cabinet.lib |
| DLL | Cabinet.dll |