IoAssignArcName function

The IoAssignArcName routine creates a symbolic link between the ARC name of a physical device and the name of the corresponding device object when it has been created.

Syntax

VOID IoAssignArcName(
  _In_ PUNICODE_STRING ArcName,
  _In_ PUNICODE_STRING DeviceName
);

Parameters

ArcName

Pointer to a buffer containing the ARC name of the device. The ARC name must be a Unicode string.

DeviceName

Pointer to a buffer containing the name of the device object, representing the same device. The device object name must be a Unicode string.

Return Value

None

Remarks

Drivers of hard disk devices need not call this routine. Drivers of other mass storage devices, including floppy, CD-ROM, and tape devices, should call IoAssignArcName during their initialization.

Requirements

   
Windows version Available starting with Windows 2000. Available starting with Windows 2000.
Target Platform Desktop
Header ntddk.h (include Ntddk.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI compliance rules HwStorPortProhibitedDDIs

See Also

IoCreateDevice

Send comments about this topic to Microsoft