Merge recent doc changes for OEMCrypto

This is a cherry pick of recent changes to OEMCrypto and ODK. Most of
these are part of the document migration to doxygen.

See http://go/wvgerrit/106005 and its parents for code reviews.

Bug: 144715340
Bug: 148232693
Bug: 167580674
Change-Id: I658f99c8117b974faed97322d61fac0f382283af

libwvdrmengine/oemcrypto/odk/src/odk.c

@@ -1,6 +1,6 @@
-/* Copyright 2019 Google LLC. All rights reserved. This file and proprietary */
-/* source code may only be used and distributed under the Widevine Master */
-/* License Agreement. */
+// Copyright 2019 Google LLC. All rights reserved. This file and proprietary
+// source code may only be used and distributed under the Widevine Master
+// License Agreement.
 
 #include "odk.h"
 
@@ -19,7 +19,7 @@
 
 static OEMCryptoResult ODK_PrepareRequest(
     uint8_t* message, size_t message_length, size_t* core_message_length,
-    uint32_t message_type, const ODK_NonceValues* nonce_values,
+    ODK_MessageType message_type, const ODK_NonceValues* nonce_values,
     void* prepared_request_buffer, size_t prepared_request_buffer_length) {
   if (nonce_values == NULL || core_message_length == NULL ||
       prepared_request_buffer == NULL ||
@@ -27,8 +27,8 @@ static OEMCryptoResult ODK_PrepareRequest(
     return ODK_ERROR_CORE_MESSAGE;
   }
 
-  Message* msg = NULL;
-  AllocateMessage(&msg, message_block);
+  uint8_t blk[SIZE_OF_MESSAGE_STRUCT];
+  Message* msg = (Message*)blk;
   InitMessage(msg, message, *core_message_length);
 
   /* The core message should be at the beginning of the buffer, and with a
@@ -95,18 +95,24 @@ static OEMCryptoResult ODK_PrepareRequest(
 
 static OEMCryptoResult ODK_ParseResponse(
     const uint8_t* message, size_t message_length, size_t core_message_length,
-    uint32_t message_type, const ODK_NonceValues* nonce_values,
+    ODK_MessageType message_type, const ODK_NonceValues* nonce_values,
     void* response_buffer, uint32_t response_buffer_length) {
   if (message == NULL || response_buffer == NULL ||
       core_message_length > message_length) {
     return ODK_ERROR_CORE_MESSAGE;
   }
 
-  Message* msg = NULL;
-  AllocateMessage(&msg, message_block);
+  uint8_t blk[SIZE_OF_MESSAGE_STRUCT];
+  Message* msg = (Message*)blk;
+
+#pragma GCC diagnostic push
+#pragma GCC diagnostic ignored "-Wcast-qual"
   /* We initialize the message buffer with a size of the entire message
    * length. */
+  /* TODO(b/164486737): Fix the cast-qual warning */
   InitMessage(msg, (uint8_t*)message, message_length);
+#pragma GCC diagnostic pop
+
   /* The core message should be at the beginning of the buffer, and with a
    * shorter length. The core message is the part we are parsing. */
   SetSize(msg, core_message_length);
@@ -168,7 +174,7 @@ OEMCryptoResult ODK_PrepareCoreLicenseRequest(
     return ODK_ERROR_CORE_MESSAGE;
   }
   ODK_PreparedLicenseRequest license_request = {
-      {0},
+      {0, 0, {}},
   };
   return ODK_PrepareRequest(
       message, message_length, core_message_length, ODK_License_Request_Type,
@@ -197,7 +203,7 @@ OEMCryptoResult ODK_PrepareCoreRenewalRequest(uint8_t* message,
     return OEMCrypto_SUCCESS;
   }
 
-  ODK_PreparedRenewalRequest renewal_request = {{0}, 0};
+  ODK_PreparedRenewalRequest renewal_request = {{0, 0, {}}, 0};
   /* First, we compute the time this request was made relative to the playback
    * clock. */
   if (clock_values->time_of_first_decrypt == 0) {
@@ -231,14 +237,14 @@ OEMCryptoResult ODK_PrepareCoreProvisioningRequest(
     return ODK_ERROR_CORE_MESSAGE;
   }
   ODK_PreparedProvisioningRequest provisioning_request = {
-      {0},
+      {0, 0, {}},
       0,
       {0},
   };
   if (device_id_length > sizeof(provisioning_request.device_id)) {
     return ODK_ERROR_CORE_MESSAGE;
   }
-  provisioning_request.device_id_length = device_id_length;
+  provisioning_request.device_id_length = (uint32_t)device_id_length;
   if (device_id) {
     memcpy(provisioning_request.device_id, device_id, device_id_length);
   }
@@ -261,7 +267,9 @@ OEMCryptoResult ODK_ParseLicense(
     return ODK_ERROR_CORE_MESSAGE;
   }
 
-  ODK_LicenseResponse license_response = {{{0}}, parsed_license, {0}};
+  ODK_LicenseResponse license_response = {{{0, 0, {}}}, NULL, {0}};
+  license_response.parsed_license = parsed_license;
+
   const OEMCryptoResult err = ODK_ParseResponse(
       message, message_length, core_message_length, ODK_License_Response_Type,
       NULL, &license_response, sizeof(ODK_LicenseResponse));
@@ -342,7 +350,7 @@ OEMCryptoResult ODK_ParseRenewal(const uint8_t* message, size_t message_length,
   }
 
   ODK_RenewalResponse renewal_response = {
-      {{0}, 0},
+      {{0, 0, {}}, 0},
       0,
   };
   const OEMCryptoResult err = ODK_ParseResponse(
@@ -378,8 +386,9 @@ OEMCryptoResult ODK_ParseProvisioning(
     return ODK_ERROR_CORE_MESSAGE;
   }
 
-  ODK_ProvisioningResponse provisioning_response = {{{0}, 0, {0}},
-                                                    parsed_response};
+  ODK_ProvisioningResponse provisioning_response = {{{0, 0, {}}, 0, {0}}, NULL};
+  provisioning_response.parsed_provisioning = parsed_response;
+
   if (device_id_length > ODK_DEVICE_ID_LEN_MAX) {
     return ODK_ERROR_CORE_MESSAGE;
   }