Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The RegisterForEvent method registers the application to receive events from the codec.
Syntax
HRESULT RegisterForEvent(
[in] const GUID *Api,
[out] LONG_PTR userData
);
Parameters
[in] Api
Pointer to a GUID that specifies the event. There are three categories of events:
| Value | Meaning |
|---|---|
|
The codec notifies the application when the properties of the codec change. The event data is a list of GUIDs for the properties that changed. |
|
The codec notifies the application when the specified property changes. Typically, a codec will support this type of notification for a limited set of properties, if any. |
|
Implementation dependent. |
[out] userData
Pointer to caller-defined data. The application receives this pointer in the lParam1 event parameter.
Return value
This method can return one of these values.
| Return code | Description |
|---|---|
|
The method succeeded. |
|
Not implemented. The codec does not support event notification, or does not support the event GUID specified in the Api parameter. |
Remarks
The application receives an EC_CODECAPI_EVENT event notification whenever the encoder codec sends the event. To get the event, uses the IMediaEventEx interface.
The lParam2 parameter of the event is a pointer to a CodecAPIEventData structure. This structure can be followed by additional data, depending on the event GUID. The size of this data is given by the dataLength member.
| GUID | Event Data |
|---|---|
| CODECAPI_CHANGELISTS | An array of GUIDs. Each GUID specifies a codec property whose current value or valid range has changed. The size of the array is dataLength / sizeof(GUID). |
| A property GUID defined in codecapi.h. | None. |
| Proprietary event GUID. | Implementation dependent. |
If the codec does not support the specified event, the method returns E_NOTIMPL. The codec might support other events.
To disable notifications for an event, call ICodecAPI::UnregisterForEvent.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 10 Build 20348 |
| Minimum supported server | Windows 10 Build 20348 |
| Header | icodecapi.h |