MFBeginCreateFile 함수(mfapi.h)

파일에서 바이트 스트림을 만드는 비동기 요청을 시작합니다.

구문

HRESULT MFBeginCreateFile(
  [in]  MF_FILE_ACCESSMODE AccessMode,
  [in]  MF_FILE_OPENMODE   OpenMode,
  [in]  MF_FILE_FLAGS      fFlags,
  [in]  LPCWSTR            pwszFilePath,
  [in]  IMFAsyncCallback   *pCallback,
  [in]  IUnknown           *pState,
  [out] IUnknown           **ppCancelCookie
);

매개 변수

[in] AccessMode

요청된 액세스 모드로, MF_FILE_ACCESSMODE 열거형의 멤버로 지정됩니다.

[in] OpenMode

파일이 이미 있거나 존재하지 않는 경우 함수의 동작이며 , MF_FILE_OPENMODE 열거형의 멤버로 지정됩니다.

[in] fFlags

MF_FILE_FLAGS 열거형의 값의 비트 OR입니다.

[in] pwszFilePath

파일 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.

[in] pCallback

콜백 개체의 IMFAsyncCallback 인터페이스에 대한 포인터입니다. 호출자는 이 인터페이스를 구현해야 합니다.

[in] pState

호출자가 정의한 상태 개체의 IUnknown 인터페이스에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다. 이 개체를 사용하여 상태 정보를 저장할 수 있습니다. 콜백이 호출될 때 개체가 호출자에게 반환됩니다.

[out] ppCancelCookie

IUnknown 포인터 또는 NULL 값을 받습니다. 값이 NULL이 아닌 경우 MFCancelCreateFile 함수에 이 포인터를 전달하여 비동기 작업을 취소할 수 있습니다. 호출자는 인터페이스를 해제해야 합니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.

반환 값

함수는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드	설명
S_OK	함수가 성공했습니다.

설명

요청이 완료되면 콜백 개체의 IMFAsyncCallback::Invoke 메서드가 호출됩니다. 그런 다음 콜백 개체는 MFEndCreateFile 함수를 호출하여 바이트 스트림에 대한 포인터를 가져와야 합니다.

요구 사항

지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	mfapi.h
라이브러리	Mfplat.lib
DLL	Mfplat.dll

참고 항목

미디어 파운데이션 함수