[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 |