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;
}
}
요구 사항
| 요구 사항 | 값 |
|---|---|
| 최소 UMDF 버전 | 2.27 |
| 머리글 | wdfdriver.h |
| IRQL | PASSIVE_LEVEL |