IWDFIoTarget::FormatRequestForIoctl 메서드(wudfddi.h)

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

FormatRequestForIoctl 메서드는 I/O 컨트롤 작업에 대한 I/O 요청 개체의 형식을 지정합니다.

통사론

HRESULT FormatRequestForIoctl(
  [in]           IWDFIoRequest     *pRequest,
  [in]           ULONG             IoctlCode,
  [in, optional] IWDFFile          *pFile,
  [in, optional] IWDFMemory        *pInputMemory,
  [in, optional] PWDFMEMORY_OFFSET pInputMemoryOffset,
  [in, optional] IWDFMemory        *pOutputMemory,
  [in, optional] PWDFMEMORY_OFFSET pOutputMemoryOffset
);

매개 변수

[in] pRequest

형식을 지정할 요청 개체의 IWDFIoRequest 인터페이스에 대한 포인터입니다.

[in] IoctlCode

수행할 특정 작업을 식별하는 컨트롤 코드입니다.

[in, optional] pFile

I/O 컨트롤 요청과 연결된 파일 개체의 IWDFFile 인터페이스에 대한 포인터입니다. 기본 I/O 대상의 경우 이 매개 변수는 NULL이 아니어야 합니다.

[in, optional] pInputMemory

요청에 대한 입력 버퍼에 액세스하는 데 사용되는 IWDFMemory 인터페이스에 대한 포인터입니다. 이 매개 변수는 선택 사항입니다.

[in, optional] pInputMemoryOffset

요청에 대한 입력 메모리 오프셋을 설명하는 WDFMEMORY_OFFSET 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항입니다.

[in, optional] pOutputMemory

요청에 대한 출력 버퍼에 액세스하는 데 사용되는 IWDFMemory 인터페이스에 대한 포인터입니다. 이 매개 변수는 선택 사항입니다.

[in, optional] pOutputMemoryOffset

요청에 대한 출력 메모리 오프셋을 설명하는 WDFMEMORY_OFFSET 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항입니다.

반환 값

FormatRequestForIoctl 작업이 성공하면 S_OK 반환합니다. 그렇지 않으면 이 메서드는 Winerror.h에 정의된 오류 코드 중 하나를 반환합니다.

요구 사항

요구	값
지원 종료	UMDF 2.0 이상에서는 사용할 수 없습니다.
대상 플랫폼	바탕 화면
최소 UMDF 버전	1.5
헤더	wudfddi.h(Wudfddi.h 포함)
DLL	WUDFx.dll

참고 항목

IWDFFile

IWDFIoRequest

IWDFIoTarget

IWDFMemory

WDFMEMORY_OFFSET