<!--
{
  "availability" : [
    "macOS: 14.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "MediaExtension",
  "identifier" : "/documentation/MediaExtension/MESampleCursor/loadPostDecodeProcessingMetadata(completionHandler:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "MediaExtension"
    ],
    "preciseIdentifier" : "c:objc(pl)MESampleCursor(im)loadPostDecodeProcessingMetadataWithCompletionHandler:"
  },
  "title" : "loadPostDecodeProcessingMetadata(completionHandler:)"
}
-->

# loadPostDecodeProcessingMetadata(completionHandler:)

Asynchronously loads a dictionary that represents frame level metadata for post decode processing.

```
optional func loadPostDecodeProcessingMetadata(completionHandler: @escaping @Sendable ([String : any Sendable]?, (any Error)?) -> Void)
```

```
optional func postDecodeProcessingMetadata() async throws -> [String : any Sendable]
```

## Parameters

`completionHandler`

The handler that will be invoked when the method completes.

## Discussion

This method should provide either a valid NSDictionary or `nil`. If the method fails, the NSError will contain error information.

The post decode processing metadata could either be contained in the media asset primary file or be located in a separate related “sidecar” file. If contained in a separate file with a different extension, that file extension should be included in the EXAppExtensionAttributes and UTExportedTypeDeclarations dictionaries in the MediaExtension format reader `Info.plist`. The metadata returned should contain sequence level metadata for post decode processing, along with optional frame level metadata if present.

Typically the metadata returned by this method is delivered to the video decoder through sample buffer attachments.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)