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비트 는 파일이 없거나 아직 없는 경우 수행할 작업을 나타냅니다. 이러한 비트에 대한 자세한 내용은 ZwCreateFile의 CreateDisposition 매개 변수에 대한 설명을 참조하세요.

이 매개 변수는 선택 사항이며 NULL일 수 있습니다.

[out, optional] pFileAttributes

파일 특성을 나타내는 비트 플래그를 수신하는 호출자가 할당한 변수에 대한 포인터입니다. 이러한 FILE_ATTRIBUTE_XXXX 명명된 비트 플래그는 Wdm.h에 정의됩니다. 이러한 비트 플래그에 대한 자세한 내용은 ZwCreateFile의 FileAttributes 매개 변수에 대한 설명을 참조하세요.

이 매개 변수는 선택 사항이며 NULL일 수 있습니다.

[out, optional] pShareAccess

파일 공유 옵션을 나타내는 비트 플래그를 수신하는 호출자가 할당한 변수에 대한 포인터입니다. 이러한 FILE_SHARE_XXXX 명명된 비트 플래그는 Wdm.h에 정의되어 있습니다. 이러한 비트 플래그에 대한 자세한 내용은 ZwCreateFile의 ShareAccess 매개 변수에 대한 설명을 참조하세요.

이 매개 변수는 선택 사항이며 NULL일 수 있습니다.

[out, optional] pDesiredAccess

파일에 대한 요청된 액세스를 지정하는 호출자가 할당한 ACCESS_MASK 구조체에 대한 포인터입니다. 이 매개 변수에 대한 자세한 내용은 ZwCreateFile의 DesiredAccess 매개 변수를 참조하세요.

이 매개 변수는 선택 사항이며 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

추가 정보

IQueueCallbackCreate::OnCreateFile

IWDFIoRequest2

IWDFIoRequest::GetCreateParameters