共用方式為

WdfDeviceCreateSymbolicLink 函式 （wdfdevice.h）

  • 發行項

[適用於 KMDF 和 UMDF]

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

語法

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

參數

[in] Device

架構裝置物件的句柄。

[in] SymbolicLinkName

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

傳回值

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

傳回碼 描述
STATUS_INSUFFICIENT_RESOURCES
 系統無法配置空間來儲存裝置名稱。
 

方法可能會 傳回其他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 裝置名稱。

要求

要求 價值
目標平臺 普遍
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
標頭 wdfdevice.h （包括 Wdf.h）
連結庫 Wdf01000.sys （KMDF）：WUDFx02000.dll （UMDF）
IRQL PASSIVE_LEVEL
DDI 合規性規則 DriverCreate（kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf）

另請參閱

UNICODE_STRING