[VIDEOPRT] Reformat VideoPortVerifyAccessRanges()

Fix indentation, add SAL annotations and Doxygen description.
This commit is contained in:
Hermès Bélusca-Maïto 2023-06-23 15:56:20 +02:00
parent 7eca194709
commit de6313d89e
No known key found for this signature in database
GPG key ID: 3B2539C65E7B93D0
2 changed files with 89 additions and 73 deletions

View file

@ -1251,9 +1251,9 @@ VPAPI
VP_STATUS VP_STATUS
NTAPI NTAPI
VideoPortVerifyAccessRanges( VideoPortVerifyAccessRanges(
IN PVOID HwDeviceExtension, _In_ PVOID HwDeviceExtension,
IN ULONG NumAccessRanges, _In_opt_ ULONG NumAccessRanges,
IN PVIDEO_ACCESS_RANGE AccessRanges); _In_reads_opt_(NumAccessRanges) PVIDEO_ACCESS_RANGE AccessRanges);
VPAPI VPAPI
VOID VOID

View file

@ -816,15 +816,31 @@ VideoPortGetAccessRanges(
return NO_ERROR; return NO_ERROR;
} }
/* /**
* @implemented * @brief
*/ * Claims or releases a range of hardware resources and checks for conflicts.
*
VP_STATUS NTAPI * @param[in] HwDeviceExtension
* The miniport device extension.
*
* @param[in] NumAccessRanges
* The number of hardware resource ranges in the @p AccessRanges array.
* Specify zero to release the hardware resources held by the miniport.
*
* @param[in] AccessRanges
* The array of hardware resource ranges to claim ownership.
* Specify NULL to release the hardware resources held by the miniport.
*
* @return
* NO_ERROR if the resources have been successfully claimed or released.
* ERROR_INVALID_PARAMETER if an error or a conflict occurred.
**/
VP_STATUS
NTAPI
VideoPortVerifyAccessRanges( VideoPortVerifyAccessRanges(
IN PVOID HwDeviceExtension, _In_ PVOID HwDeviceExtension,
IN ULONG NumAccessRanges, _In_opt_ ULONG NumAccessRanges,
IN PVIDEO_ACCESS_RANGE AccessRanges) _In_reads_opt_(NumAccessRanges) PVIDEO_ACCESS_RANGE AccessRanges)
{ {
PVIDEO_PORT_DEVICE_EXTENSION DeviceExtension; PVIDEO_PORT_DEVICE_EXTENSION DeviceExtension;
BOOLEAN ConflictDetected; BOOLEAN ConflictDetected;