RtlIsDosDeviceName_U - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers 
#ifndef _NTRTL_H

/**
 * The RtlIsDosDeviceName_U routine examines the Dos format file name and determines if it is a Dos device name.
 *
 * \param DosFileName A pointer to the buffer that contains the DOS or Win32 filename.
 * \return A nonzero value when the Dos file name is the name of a Dos device. The high order 16 bits is the offset
 * in the input buffer where the dos device name beings and the low order 16 bits is the length of the device name (excluding any optional trailing colon).
 * Otherwise, A zero value when the Dos file name is not the name of a Dos device.
 * \sa https://learn.microsoft.com/en-us/windows/win32/devnotes/rtlisdosdevicename_u
 */
NTSYSAPI
ULONG
NTAPI
RtlIsDosDeviceName_U(
    _In_ PCWSTR DosFileName
    );

#endif

View code on GitHub
ULONG RtlIsDosDeviceName_U(
    __in PCWSTR DosFileName
)
View the official Win32 development documentation

NtDoc

This function is documented in Windows SDK.

Edit description on GitHub

Win32 development documentation (rtlisdosdevicename_u)

RtlIsDosDeviceName_U function

Examines the Dos format file name and determines if it is a Dos device name.

Parameters

isProcessorMode

A Boolean pointer provided by the calling application. After successful execution, this variable will indicate whether the OS is in processor mode or controller mode.

Return value

Value Description
0 Specified Dos file name is not the name of a Dos device.
> 0 Specified Dos file name is the name of a Dos device and the return value is a ULONG where the high order 16 bits is the offset in the input buffer where the dos device name beings and the low order 16 bits is the length of the device name the length of the name (excluding any optional trailing colon).

Remarks

Valid Dos device names are:

When n is a digit. Trailing colon is ignored if present.

This function has no associated import library or header file; you must call it using the LoadLibrary and GetProcAddress functions. The API is exported from ntdll.dll.

Requirements

Requirement Value
DLL ntdll.dll

View the official Win32 development documentation

Edit description on GitHub