IWDFIoRequest::GetCreateParameters 메서드(wudfddi.h)

  • 아티클

[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한되어 있습니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF를 사용하여 시작 참조하세요.]

GetCreateParameters 메서드는 만들기 형식 요청에 대한 요청 매개 변수를 검색합니다.

구문

void GetCreateParameters(
  [out, optional] ULONG  *pOptions,
  [out, optional] USHORT *pFileAttributes,
  [out, optional] USHORT *pShareAccess
);

매개 변수

[out, optional] pOptions

요청과 연결된 파일을 만들거나 열 때 적용되는 옵션과 파일이 이미 있는 경우 수행할 작업을 지정하는 플래그의 비트 마스크를 받는 변수에 대한 포인터입니다.

이 매개 변수의 상위 8비트는 커널 모드 ZwCreateFile 함수의 CreateDisposition 매개 변수에 해당합니다. 이러한 8비트에서는 파일이 이미 있는지 여부에 따라 수행할 작업을 지정합니다. 이러한 처리 값은 Win32 CreateFile 함수의 dwCreationDisposition 매개 변수에 사용되는 값과 다릅니다.

이 매개 변수의 하위 24비트는 ZwCreateFile의 CreateOptions 매개 변수에 해당합니다.

이 매개 변수는 선택적 요소입니다. 드라이버에 정보가 필요하지 않은 경우 드라이버는 NULL 을 전달할 수 있습니다.

[out, optional] pFileAttributes

요청과 연결된 파일을 만들거나 열 때 적용되는 특성 플래그의 비트 마스크를 수신하는 변수에 대한 포인터입니다. 명시적으로 지정된 특성은 파일을 만들거나 대체하거나 경우에 따라 덮어쓸 때만 적용됩니다. 기본적으로 단일 FILE_ATTRIBUTE_NORMAL 플래그가 지정됩니다. 그러나 이 플래그는 다른 플래그 또는 호환 플래그의 비트 OR 조합으로 재정의할 수 있습니다. 특성 플래그의 비트 마스크는 ZwCreateFile의 FileAttributes 매개 변수에 해당합니다.

이 매개 변수는 선택적 요소입니다. 드라이버에 정보가 필요하지 않은 경우 드라이버는 NULL 을 전달할 수 있습니다.

[out, optional] pShareAccess

요청과 연결된 파일에 대해 요청된 공유 액세스 권한을 지정하는 플래그의 비트 마스크를 받는 변수에 대한 포인터입니다. 수신된 비트 마스크가 0이면 단독 액세스가 요청됩니다. 공유 액세스에 대한 자세한 내용은 ZwCreateFile의 ShareAccess 매개 변수에 대한 설명을 참조하세요.

이 매개 변수는 선택적 요소입니다. 드라이버에 정보가 필요하지 않은 경우 드라이버는 NULL 을 전달할 수 있습니다.

반환 값

없음

설명

드라이버는 필요에 따라 각 pOptions, pFileAttributes 및 pShareAccess 매개 변수에 대해 NULL을 지정할 수 있지만, 드라이버는 GetCreateParameters가 성공적으로 실행되도록 NULL이 아닌 매개 변수를 하나 이상 지정해야 합니다.

요구 사항

요구 사항 값
지원 종료 UMDF 2.0 이상에서는 사용할 수 없습니다.
대상 플랫폼 데스크톱
최소 UMDF 버전 1.5
머리글 wudfddi.h(Wudfddi.h 포함)
DLL WUDFx.dll

추가 정보

IWDFIoRequest

ZwCreateFile