WdfDeviceCreateSymbolicLink 函式 (wdfdevice.h)

[適用於 KMDF 和 UMDF]

WdfDeviceCreateSymbolicLink 方法會建立指定裝置的符號連結。

語法

NTSTATUS WdfDeviceCreateSymbolicLink(
  [in] WDFDEVICE        Device,
  [in] PCUNICODE_STRING SymbolicLinkName
);

參數

[in] Device

架構裝置物件的句柄。

[in] SymbolicLinkName

包含裝置用戶可見名稱 之UNICODE_STRING 結構的指標。

傳回值

如果作業成功， WdfDeviceCreateSymbolicLink 會傳回STATUS_SUCCCESS。 其他傳回值包括：

方法可能會傳回其他 NTSTATUS值。

如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。

備註

如果驅動程式為裝置建立符號連結，應用程式可以使用符號連結名稱來存取裝置。 一般而言，架構型驅動程式不會提供符號連結，而是提供應用程式可用來存取其裝置的 裝置介面 。

如果裝置意外移除 (意外移除) ，架構就會移除裝置的符號連結。 然後，驅動程式就可以針對裝置的新實例使用符號連結名稱。

範例

下列來自 KMDF 驅動程式的程式代碼範例會建立應用程式可用來存取裝置的 MS-DOS 裝置名稱 。

#define DOS_DEVICE_NAME  L"\\DosDevices\\MyDevice"
DECLARE_CONST_UNICODE_STRING(dosDeviceName, DOS_DEVICE_NAME);
NTSTATUS  status;

status = WdfDeviceCreateSymbolicLink(
                                     controlDevice,
                                     &dosDeviceName
                                     );
if (!NT_SUCCESS(status)) {
    goto Error;
}

UMDF 驅動程式必須在全域 DosDevices 命名空間中提供符號連結名稱，如下列程式代碼範例所示。

#define DOS_DEVICE_NAME  L"\\DosDevices\\Global\\MyDevice"
DECLARE_CONST_UNICODE_STRING(dosDeviceName, DOS_DEVICE_NAME);
NTSTATUS  status;

status = WdfDeviceCreateSymbolicLink(
                                     controlDevice,
                                     &dosDeviceName
                                     );
if (!NT_SUCCESS(status)) {
    goto Error;
}

如需全域和本機 \DosDevices 命名空間的相關信息，請參閱 本機和全域 MS-DOS 裝置名稱。

規格需求

另請參閱

UNICODE_STRING