1  | 
     | 
     | 
    /**************************************************************************/  | 
    
    
    2  | 
     | 
     | 
    /*                                                                        */  | 
    
    
    3  | 
     | 
     | 
    /*       Copyright (c) Microsoft Corporation. All rights reserved.        */  | 
    
    
    4  | 
     | 
     | 
    /*                                                                        */  | 
    
    
    5  | 
     | 
     | 
    /*       This software is licensed under the Microsoft Software License   */  | 
    
    
    6  | 
     | 
     | 
    /*       Terms for Microsoft Azure RTOS. Full text of the license can be  */  | 
    
    
    7  | 
     | 
     | 
    /*       found in the LICENSE file at https://aka.ms/AzureRTOS_EULA       */  | 
    
    
    8  | 
     | 
     | 
    /*       and in the root directory of this software.                      */  | 
    
    
    9  | 
     | 
     | 
    /*                                                                        */  | 
    
    
    10  | 
     | 
     | 
    /**************************************************************************/  | 
    
    
    11  | 
     | 
     | 
     | 
    
    
    12  | 
     | 
     | 
     | 
    
    
    13  | 
     | 
     | 
    /**************************************************************************/  | 
    
    
    14  | 
     | 
     | 
    /**************************************************************************/  | 
    
    
    15  | 
     | 
     | 
    /**                                                                       */  | 
    
    
    16  | 
     | 
     | 
    /** FileX Component                                                       */  | 
    
    
    17  | 
     | 
     | 
    /**                                                                       */  | 
    
    
    18  | 
     | 
     | 
    /**   File                                                                */  | 
    
    
    19  | 
     | 
     | 
    /**                                                                       */  | 
    
    
    20  | 
     | 
     | 
    /**************************************************************************/  | 
    
    
    21  | 
     | 
     | 
    /**************************************************************************/  | 
    
    
    22  | 
     | 
     | 
     | 
    
    
    23  | 
     | 
     | 
    #define FX_SOURCE_CODE  | 
    
    
    24  | 
     | 
     | 
     | 
    
    
    25  | 
     | 
     | 
     | 
    
    
    26  | 
     | 
     | 
    /* Include necessary system files.  */  | 
    
    
    27  | 
     | 
     | 
     | 
    
    
    28  | 
     | 
     | 
    #include "fx_api.h"  | 
    
    
    29  | 
     | 
     | 
    #include "fx_file.h"  | 
    
    
    30  | 
     | 
     | 
     | 
    
    
    31  | 
     | 
     | 
    FX_CALLER_CHECKING_EXTERNS  | 
    
    
    32  | 
     | 
     | 
     | 
    
    
    33  | 
     | 
     | 
     | 
    
    
    34  | 
     | 
     | 
    /**************************************************************************/  | 
    
    
    35  | 
     | 
     | 
    /*                                                                        */  | 
    
    
    36  | 
     | 
     | 
    /*  FUNCTION                                               RELEASE        */  | 
    
    
    37  | 
     | 
     | 
    /*                                                                        */  | 
    
    
    38  | 
     | 
     | 
    /*    _fxe_file_create                                    PORTABLE C      */  | 
    
    
    39  | 
     | 
     | 
    /*                                                           6.1          */  | 
    
    
    40  | 
     | 
     | 
    /*  AUTHOR                                                                */  | 
    
    
    41  | 
     | 
     | 
    /*                                                                        */  | 
    
    
    42  | 
     | 
     | 
    /*    William E. Lamie, Microsoft Corporation                             */  | 
    
    
    43  | 
     | 
     | 
    /*                                                                        */  | 
    
    
    44  | 
     | 
     | 
    /*  DESCRIPTION                                                           */  | 
    
    
    45  | 
     | 
     | 
    /*                                                                        */  | 
    
    
    46  | 
     | 
     | 
    /*    This function checks for errors in the file create call.            */  | 
    
    
    47  | 
     | 
     | 
    /*                                                                        */  | 
    
    
    48  | 
     | 
     | 
    /*  INPUT                                                                 */  | 
    
    
    49  | 
     | 
     | 
    /*                                                                        */  | 
    
    
    50  | 
     | 
     | 
    /*    media_ptr                             Media control block pointer   */  | 
    
    
    51  | 
     | 
     | 
    /*    file_name                             File name                     */  | 
    
    
    52  | 
     | 
     | 
    /*                                                                        */  | 
    
    
    53  | 
     | 
     | 
    /*  OUTPUT                                                                */  | 
    
    
    54  | 
     | 
     | 
    /*                                                                        */  | 
    
    
    55  | 
     | 
     | 
    /*    return status                                                       */  | 
    
    
    56  | 
     | 
     | 
    /*                                                                        */  | 
    
    
    57  | 
     | 
     | 
    /*  CALLS                                                                 */  | 
    
    
    58  | 
     | 
     | 
    /*                                                                        */  | 
    
    
    59  | 
     | 
     | 
    /*    _fx_file_create                       Actual file create call       */  | 
    
    
    60  | 
     | 
     | 
    /*                                                                        */  | 
    
    
    61  | 
     | 
     | 
    /*  CALLED BY                                                             */  | 
    
    
    62  | 
     | 
     | 
    /*                                                                        */  | 
    
    
    63  | 
     | 
     | 
    /*    Application Code                                                    */  | 
    
    
    64  | 
     | 
     | 
    /*                                                                        */  | 
    
    
    65  | 
     | 
     | 
    /*  RELEASE HISTORY                                                       */  | 
    
    
    66  | 
     | 
     | 
    /*                                                                        */  | 
    
    
    67  | 
     | 
     | 
    /*    DATE              NAME                      DESCRIPTION             */  | 
    
    
    68  | 
     | 
     | 
    /*                                                                        */  | 
    
    
    69  | 
     | 
     | 
    /*  05-19-2020     William E. Lamie         Initial Version 6.0           */  | 
    
    
    70  | 
     | 
     | 
    /*  09-30-2020     William E. Lamie         Modified comment(s),          */  | 
    
    
    71  | 
     | 
     | 
    /*                                            resulting in version 6.1    */  | 
    
    
    72  | 
     | 
     | 
    /*                                                                        */  | 
    
    
    73  | 
     | 
     | 
    /**************************************************************************/  | 
    
    
    74  | 
     | 
    55256  | 
    UINT  _fxe_file_create(FX_MEDIA *media_ptr, CHAR *file_name)  | 
    
    
    75  | 
     | 
     | 
    { | 
    
    
    76  | 
     | 
     | 
     | 
    
    
    77  | 
     | 
     | 
    UINT status;  | 
    
    
    78  | 
     | 
     | 
     | 
    
    
    79  | 
     | 
     | 
     | 
    
    
    80  | 
     | 
     | 
        /* Check for a null media pointer.  */  | 
    
    
    81  | 
    ✓✓ | 
    55256  | 
        if (media_ptr == FX_NULL)  | 
    
    
    82  | 
     | 
     | 
        { | 
    
    
    83  | 
     | 
    1  | 
            return(FX_PTR_ERROR);  | 
    
    
    84  | 
     | 
     | 
        }  | 
    
    
    85  | 
     | 
     | 
     | 
    
    
    86  | 
     | 
     | 
        /* Check for a valid caller.  */  | 
    
    
    87  | 
    ✓✓✓✓ ✓✓ | 
    55255  | 
        FX_CALLER_CHECKING_CODE  | 
    
    
    88  | 
     | 
     | 
     | 
    
    
    89  | 
     | 
     | 
        /* Call actual file create service.  */  | 
    
    
    90  | 
     | 
    54847  | 
        status =  _fx_file_create(media_ptr, file_name);  | 
    
    
    91  | 
     | 
     | 
     | 
    
    
    92  | 
     | 
     | 
        /* File create is complete, return status.  */  | 
    
    
    93  | 
     | 
    54847  | 
        return(status);  | 
    
    
    94  | 
     | 
     | 
    }  | 
    
    
    95  | 
     | 
     | 
     |