Logo Search packages:      
Sourcecode: virtualbox-ose version File versions  Download package

KDBG_DECL ( int   ) 

Frees a line number obtained from the RTDbg API.

Returns:
VINF_SUCCESS on success.

KERR_INVALID_POINTER if a NULL pointer or an !KDBG_VALID_PTR() is passed in.

Parameters:
pLine The line number to be freed.
Frees a symbol obtained from the kDbg API.

Returns:
VINF_SUCCESS on success.

KERR_INVALID_POINTER if a NULL pointer or an !KDBG_VALID_PTR() is passed in.

Parameters:
pSymbol The symbol to be freed.
Register a debug module reader with the kDbgModule component.

Dynamically registered readers are kept in FIFO order, and external readers will be tried after the builtin ones.

Returns:
0 on success.

KERR_INVALID_POINTER if pOps is missing bits.

KERR_INVALID_PARAMETER if pOps is already in the list.

Parameters:
pOps The reader method table, kDbg takes owner ship of this. This must be writeable as the pNext pointer will be update. It must also stick around for as long as kDbg is in use.
Deregister a debug module reader previously registered using the kDbgModuleRegisterReader API.

Deregistering a reader does not mean that non of its functions will be called after successful return, it only means that it will no longer be subjected to new module.

Returns:
0 on success.

KERR_INVALID_POINTER if pOps isn't a valid pointer.

KERR_INVALID_PARAMETER if pOps wasn't registered.

Parameters:
pOps The debug module method table to deregister.
Opens a debug module reader for the specified file or file section

Returns:
kStuff status code.
Parameters:
ppDbgMod Where to store the debug module reader handle.
pRdr The file reader.
off The offset of the file section. If the entire file, pass 0.
cb The size of the file section. If the entire file, pass KFOFF_MAX.
pLdrMod Associated kLdr module that the kDbg component can use to verify and suplement the debug info found in the file specified by pszFilename. The module will be used by kDbg for as long as the returned kDbg module remains open. This is an optional parameter, pass NULL if no kLdr module at hand.
Frees a line number obtained from the kDbg API.

Returns:
0 on success.

KERR_INVALID_POINTER if pLine isn't a valid pointer.

Parameters:
pLine The line number to be freed. The null pointer is ignored.
Register a debug module reader with the kDbgModule component.

Dynamically registered readers are kept in FIFO order, and external readers will be tried after the builtin ones.

Like all other kDbg APIs serializing is left to the caller.

Returns:
0 on success.

KERR_INVALID_POINTER if pOps is missing bits.

KERR_INVALID_PARAMETER if pOps is already in the list.

Parameters:
pOps The reader method table, kDbg takes owner ship of this. This must be writeable as the pNext pointer will be update. It must also stick around for as long as kDbg is in use.
Deregister a debug module reader previously registered using the kDbgModuleRegisterReader API.

Deregistering a reader does not mean that non of its functions will be called after successful return, it only means that it will no longer be subjected to new module.

Returns:
0 on success.

KERR_INVALID_POINTER if pOps isn't a valid pointer.

KERR_INVALID_PARAMETER if pOps wasn't registered.

Parameters:
pOps The debug module method table to deregister.
Opens a debug module reader for the specified file or file section

Returns:
kStuff status code.
Parameters:
ppDbgMod Where to store the debug module reader handle.
pRdr The file reader.
off The offset of the file section. If the entire file, pass 0.
cb The size of the file section. If the entire file, pass KFOFF_MAX.
pLdrMod Associated kLdr module that the kDbg component can use to verify and suplement the debug info found in the file specified by pszFilename. The module will be used by kDbg for as long as the returned kDbg module remains open. This is an optional parameter, pass NULL if no kLdr module at hand.
Frees a symbol obtained from the kDbg API.

Returns:
0 on success.

KERR_INVALID_POINTER if pSymbol isn't a valid pointer.

Parameters:
pSymbol The symbol to be freed. The null pointer is ignored.

Definition at line 132 of file kDbgModule.cpp.

References KERR_INVALID_PARAMETER, KERR_INVALID_POINTER, NULL, and KDBGMODOPS::pNext.

{
    /*
     * Validate the pointer.
     */
    kDbgAssertPtrReturn(pOps, KERR_INVALID_POINTER);

    /*
     * Find it in the list and unlink it.
     */
    if (g_pHead == pOps)
        g_pHead = pOps->pNext;
    else
    {
        PKDBGMODOPS pPrev = g_pHead;
        while (pPrev && pPrev->pNext != pOps)
            pPrev = pPrev->pNext;
        if (!pPrev)
            return KERR_INVALID_PARAMETER;
        pPrev->pNext = pOps->pNext;
    }
    pOps->pNext = NULL;
    return 0;
}


Generated by  Doxygen 1.6.0   Back to index