windows.c File Reference

#include "debug.h"
#include "utils/windows.h"

Include dependency graph for windows.c:

Go to the source code of this file.

Macros
#define	MOD_NAME   "[utils/win] "

Functions
bool	com_initialize (bool *com_initialized, const char *err_prefix)
void	com_uninitialize (bool *com_initialized)

Detailed Description

Author

Martin Pulec pulec.nosp@m.@ces.nosp@m.net.c.nosp@m.z

Definition in file windows.c.

Macro Definition Documentation

MOD_NAME

#define MOD_NAME   "[utils/win] "

Definition at line 53 of file windows.c.

Function Documentation

com_initialize()

bool com_initialize	(	bool *	com_initialized,
		const char *	err_prefix )

Parameters

[out]	com_initialize	a pointer to a bool that will be passed to com_uninintialize(). The value should be initialized to false - the current logic can guard only one init/uninit so true is assumed bo be a repeated call.
[in]	err_prefix	optional error prefix to be used for eventual error messges (may be NULL)

Return values

true	if either COM already initalized for this thread or this call initializes COM succesfully
false	COM could not have been initialized

Definition at line 65 of file windows.c.

{
        if (*com_initialized) {
                MSG(WARNING, "com_initialized should be initalized to false "
                             "upon the call!\n");
        }
#ifdef _WIN32
        if (err_prefix == NULL) {
                err_prefix = "";
        }
        *com_initialized = false;
        // Initialize COM on this thread
        HRESULT result = CoInitializeEx(NULL, COINIT_MULTITHREADED);
        if (SUCCEEDED(result)) {
                *com_initialized = true;
                return true;
        }
        if (result == RPC_E_CHANGED_MODE) {
                log_msg(LOG_LEVEL_WARNING, "%sCOM already intiialized with a different mode!\n", err_prefix);
                return true;
        }
        log_msg(LOG_LEVEL_ERROR, "%sInitialize of COM failed - %s\n", err_prefix, hresult_to_str(result));
        return false;
#else
        (void) com_initialized, (void) err_prefix;
        return true;
#endif
}

References LOG_LEVEL_ERROR, LOG_LEVEL_WARNING, log_msg(), and MSG.

Referenced by vidcap_decklink_state::vidcap_decklink_state(), audio_cap_wasapi_init(), audio_cap_wasapi_probe(), audio_play_wasapi_help(), audio_play_wasapi_init(), audio_play_wasapi_probe(), blackmagic_api_version_check(), common_init(), common_preinit(), create_decklink_iterator(), print_decklink_version(), and show_help().

Here is the call graph for this function:

com_uninitialize()

void com_uninitialize

(

bool *

com_initialized

)

Definition at line 94 of file windows.c.

{
#ifdef _WIN32
        if (!*com_initialized) {
                return;
        }
        *com_initialized = false;
        CoUninitialize();
#else
        (void) com_initialized;
#endif
}

Referenced by vidcap_decklink_state::~vidcap_decklink_state(), audio_cap_wasapi_probe(), audio_play_wasapi_help(), audio_play_wasapi_init(), audio_play_wasapi_probe(), cleanup(), common_cleanup(), decklink_uninitialize(), print_decklink_version(), and show_help().