WdfDriverRetrieveDriverDataDirectoryString 함수(wdfdriver.h)

[UMDF에만 적용]

WdfDriverRetrieveDriverDataDirectoryString 메서드는 드라이버가 정보를 저장할 수 있는 디스크의 디렉터리에 대한 경로를 반환합니다. 해당 디렉터리의 파일은 특정 프레임워크 드라이버 개체에 적용됩니다.

구문

NTSTATUS WdfDriverRetrieveDriverDataDirectoryString(
  [_In_] WDFDRIVER Driver,
  [_In_] WDFSTRING String
);

매개 변수

[_In_] Driver

드라이버가 WdfDriverCreate 또는 WdfDeviceGetDriver 에 대한 이전 호출에서 가져온 드라이버의 프레임워크 드라이버 개체 에 대한 핸들입니다.

[_In_] String

드라이버가 WdfStringCreate에 대한 이전 호출에서 가져온 프레임워크 문자열 개체에 대한 핸들입니다. 프레임워크는 요청된 드라이버 디렉터리의 정규화된 경로를 문자열 개체에 할당합니다.

반환 값

WdfDriverRetrieveDriverDataDirectoryString 은 작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 이 메서드는 적절한 NTSTATUS 오류 코드를 반환합니다. 자세한 내용은 NTSTATUS 값을 참조하세요.

설명

동일한 결과를 얻으려면 KMDF 드라이버가 IoGetDriverDirectory 를 대신 호출해야 합니다.

문자열 개체에 대한 자세한 내용은 문자열 개체 사용을 참조하세요.

예제

다음 코드 예제에서는 WdfDriverRetrieveDriverDataDirectoryString을 호출하는 방법을 보여줍니다.

NTSTATUS status;
WDFSTRING string;

status = WdfStringCreate(
                         NULL,
                         WDF_NO_OBJECT_ATTRIBUTES,
                         &string
                         );
if (NT_SUCCESS(status)) {
    status = WdfDriverRetrieveDriverDataDirectoryString(
                         Driver,
                         string
                         );
    if (!NT_SUCCESS(status)) {
        return status;
    }
}

요구 사항

추가 정보

IoGetDriverDirectory

_DRIVER_DIRECTORY_TYPE 열거형