IWDFIoRequest2::GetCreateParametersEx 메서드(wudfddi.h)
[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에는 새로운 기능이 추가되지 않으며 최신 버전의 Windows 10에서는 UMDF 1에 대한 지원이 제한되어 있습니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF시작 .]을 참조하세요.
GetCreateParametersEx 메서드는 생성되거나 열려 있는 파일과 연결된 파일 생성 매개 변수를 검색합니다.
통사론
void GetCreateParametersEx(
[out, optional] ULONG *pOptions,
[out, optional] USHORT *pFileAttributes,
[out, optional] USHORT *pShareAccess,
[out, optional] ACCESS_MASK *pDesiredAccess
);
매개 변수
[out, optional] pOptions
파일 생성 옵션을 나타내는 비트 플래그를 수신하는 호출자 할당 변수에 대한 포인터입니다. 이러한 FILE_XXXX 명명된 비트 플래그는 Wdm.h에 정의됩니다.
낮은 24비트 변수는 파일을 만들거나 열 때 적용할 옵션을 나타냅니다. 이러한 비트에 대한 자세한 내용은 커널 모드 ZwCreateFile 함수의 CreateOptions 매개 변수에 대한 설명을 참조하세요.
변수의 상위 8비트(8비트)는 파일이 없거나 아직 없는 경우 수행할 작업을 나타냅니다. 이러한 비트에 대한 자세한 내용은 ZwCreateFileCreateDisposition 매개 변수에 대한 설명을 참조하세요.
이 매개 변수는 선택 사항이며 NULL 수 있습니다.
[out, optional] pFileAttributes
파일 특성을 나타내는 비트 플래그를 수신하는 호출자 할당 변수에 대한 포인터입니다. 이러한 FILE_ATTRIBUTE_XXXX 명명된 비트 플래그는 Wdm.h에 정의됩니다. 이러한 비트 플래그에 대한 자세한 내용은 ZwCreateFileFileAttributes 매개 변수에 대한 설명을 참조하세요.
이 매개 변수는 선택 사항이며 NULL 수 있습니다.
[out, optional] pShareAccess
파일 공유 옵션을 나타내는 비트 플래그를 수신하는 호출자 할당 변수에 대한 포인터입니다. 이러한 FILE_SHARE_XXXX 명명된 비트 플래그는 Wdm.h에 정의됩니다. 이러한 비트 플래그에 대한 자세한 내용은 ZwCreateFileShareAccess 매개 변수에 대한 설명을 참조하세요.
이 매개 변수는 선택 사항이며 NULL 수 있습니다.
[out, optional] pDesiredAccess
파일에 대한 요청된 액세스를 지정하는 호출자 할당 ACCESS_MASK 구조체에 대한 포인터입니다. 이 매개 변수에 대한 자세한 내용은 ZwCreateFileDesiredAccess 매개 변수를 참조하세요.
이 매개 변수는 선택 사항이며 NULL 수 있습니다.
반환 값
없음
발언
프레임워크가 드라이버의 IQueueCallbackCreate::OnCreateFile 콜백 함수를 호출한 후 드라이버는 IWDFIoRequest::GetCreateParameters 메서드 또는 IWDFIoRequest2::GetCreateParametersEx 메서드를 호출하여 파일의 생성 매개 변수를 가져올 수 있습니다.
자세한 내용은 I/O 요청대한 매개 변수 가져오기를 참조하세요.
예제
다음 코드 예제에서는 IQueueCallbackCreate::OnCreateFile 콜백 함수가 IWDFIoRequest2 인터페이스를 가져온 다음 GetCreateParametersEx호출하는 방법을 보여 줍니다.
VOID
OnCreateFile(
__in IWDFIoQueue* FxQueue,
__in IWDFIoRequest* FxRequest,
__in IWDFFile* FxFile
)
{
ULONG fileOptions;
USHORT fileAttributes,
USHORT shareAccess,
ACCESS_MASK desiredAccess;
...
CComQIPtr<IWDFIoRequest2> fxRequest2(FxRequest);
fxRequest2->GetCreateParametersEx(&fileOptions
&fileAttributes,
&shareAccess,
&desiredAccess);
...
}
요구 사항
| 요구 | 값 |
|---|---|
| 지원 종료 | UMDF 2.0 이상에서는 사용할 수 없습니다. |
| 대상 플랫폼 | 바탕 화면 |
| 최소 UMDF 버전 | 1.9 |
| 헤더 | wudfddi.h(Wudfddi.h 포함) |
| DLL | WUDFx.dll |